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PREFACE 


a.  The  present  PILOT  terminal  is  the  product  of  a  long  evolution 

of  special  purpose  loran  processors  developed  at  the  Applied  Physics 
Laboratory.  In  1968  a  Loran  Assist  Device  (LAD)  was  developed  for  a  unique 
military  aircraft  requirement  and  was  followed  by  several  other  military 
versions.  In  1970  a  U.S.  Coast  Guard  Loran  Assist  Device  (COGLAD)  was 
developed  to  evaluate  loran  as  an  aid  to  positioning  buoys.  With  the 

development  of  microprocessors  in  1973,  a  small,  simple  processor  (CLAD)  was 

developed  and  tested  by  the  U.S.  Coast  Guard.  The  original  COGLAD  was 

upgraded  and  tested  on  the  St  Marys  River  in  1976.  Each  new  system  utilized 

increasingly  sophisticated  data  processing  techniques,  required  less  operator 
training  and  attention,  and  represented  a  lower  potential  production  cost. 
These  improvements  were  largely  the  result  of  the  phenomenal  developments  in 
the  integrated  circuit  and  microprocessor  industry  in  the  last  decade. 

b.  The  design  objective  of  the  PILOT  system  was  to  demonstrate 
that  loran  repeatability  (i.e.,  returning  to  presurveyed  way  points)  could  be 
used  successfully  to  pilot  harbors  and  rivers  without  significantly  increasing 
the  workload  of  the  bridge  personnel,  and  that  the  system  could  be  mass 
produced  by  industry  at  an  affordable  price.  To  minimize  development  and 
production  costs,  a  commercially  available  microprogrammable  graphics  terminal 
was  selected  as  the  nucleus  of  the  PILOT  system.  Significant  hardware 
modifications  were  required,  but  most  are  of  the  plug-in  or  bolt-on  type  and 
do  not  change  the  basic  graphics  terminal.  The  loran  receiver  currently  used 
with  the  system  is  an  unmodified  commercial  item.  Extensive  new  software  was 
developed  for  this  application  and  included  sophisticated  data  filtering  and 
transformation  techniques. 

c.  This  report,  documenting  the  PILOT  system,  is  in  three 

volumes:  Users  Manual  (Vol.  I),  Hardware  (Vol.  II),  and  Software  (this 

volume).  Additional  documentation  is  contained  in  three  Hewlett-Packard 
publications.* 


"Hewlett -Packard,  Reference"  Manual  for  2648A  Graphics  Terminal.  Part  No. 
02648-90002,  Hewlett-Packard  Company,  19435  Homestead  Road,  Cuoertino, 
California,  95014,  1978. 

Hewlett-Packard,  Technical  Information  Package  for  264XX  Data  Terminal  Part  No 
13255-91000,  Hewlett-Packard  Company,  19400  Homestead  Road,  Cupertino, 
California,  95014,  1977. 


Hewlett-Packard,  2645A  Operating  System  Microcode.  Part 
Hewlett-Packard  Comoanv.  19400  Homestead  Road.  Cuoertino. 


No.  13255-90003, 
California. 
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1.0 


INTRODUCTION. 


1.1  General ; 

a.  The  PILOT  terminal,  developed  by  the  Applied  Physics 
Laboratory  of  The  Johns  Hopkins  University  for  the  U.S.  Coast  Guard,  is  an 
electronic  aid  to  piloting  vessels  in  harbors  and  rivers.  Its  purpose  is  to 
provide  accurate  navigation  information  in  a  format  that  can  be  immediately 
used  without  significantly  increasing  the  bridge  workload.  It  is  not  intended 
to  make  value  judgments  or  steer  the  ship,  but  it  does  provide  the  ship  with 
continuous  and  accurate  position  information  over-the-bottom.  The  PILOT 
terminal  obtains  its  information  from  a  Loran-C  receiver,  the  ship's  gyro,  and 
charts  and  loran  coefficients  prerecorded  on  magnetic  tape  cartridges.  These 
data  are  edited  for  accuracy,  filtered  for  smoothness,  and  mathematically 
transformed  into  various  display  formats.  The  data  are  presented  graphically 
with  respect  to  a  local  way  point  (WP),  and  as  a  horizontal  bar  graph  to  aid 
channel  keeping.  The  startup  procedure  for  the  PILOT  system  consists  basi¬ 
cally  of  selecting  the  appropriate  tape  cartridge  and,  after  the  receiver  has 
automatically  acquired  the  loran  signals,  commanding  the  PILOT  terminal  to 
start  navigation.  Once  started,  the  PILOT  system  will  continuously  compute 
position  and  velocity  information,  and  select  new  area  charts  as  necessary 
without  further  operator  action.  The  operator  may  enable  optional  features 
and  display  enhancements  if  desired. 

b.  Prerecorded  tape  cartridges  containing  a  sequence  of  charts 
and  other  navigation  information  provide  the  PILOT  terminal  with  a  degree  of 
"local  knowledge".  The  vessel's  present  position,  speed,  and  heading,  contin¬ 
uously  determined  from  a  loran  receiver  and  the  vessel's  gyro,  are  displayed 
on  the  current  area  chart.  Charts  of  two  different  scales  (master  and  detail) 
are  always  available  for  operator  selection.  Position,  speed,  and  time  to  go 
(TTG)  relative  to  way  points  are  displayed  to  the  left  of  the  chart.  A  hori¬ 
zontal  bar  graph,  representing  the  vessel's  crosstrack  position  relative  to 
the  track  line,  can  be  displayed  along  the  bottom  of  the  display. 

c.  Other  features  available  to  the  operator  include  a  capability 
for  projecting  the  vessel's  expected  track  line,  continuous  readout  of  range 
and  bearing  from  ownship  to  any  point  of  the  displayed  chart,  a  time-of-day 
clock,  and  zoom  in,  zoom  out,  and  pan  on  the  display  chart.  The  operator  can 
enter  time  difference  (TO)  bias  values  to  compensate  for  seasonal  variation, 
select  from  three  types  of  vessel  projections,  select  from  four  data  filter 
time  constants,  and  display  ship's  gyro  and  loran  receiver  data.  Using  a 
special  diagostic  tape  cartridge  the  operator  can  perform  self  tests  on  the 
PILOT  terminal.  When  used  with  a  line  printer  the  PILOT  terminal  can  print 
position  information  at  a  fixed  time  interval,  or  be  used  as  a  survey  system 
to  measure  the  mean  and  standard  deviation  of  the  TD's  of  the  vessel's  present 
position. 
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a.  The  PILOT  terminal  Is  shown  in  Fig.  1-1,  and  the  system  block 
diagram  is  shown  in  Fig.  1-2.  Normal  shipboard  installation  consists  of  the 
PILOT  terminal,  a  loran  receiver  (currently  the  Internav  404  receiver)  and  a 
cable  connection  to  the  ship's  gyro.  Optional  equipment  includes  a  second 
loran  receiver  (for  cross  chain  operation),  an  interface  or  modem  for  remotely 
entering  TO  bias  values,  and  a  printer. 

b.  The  nucleus  of  the  PILOT  system  is  an  HP  2649A 
microprogranmable  graphics  terminal.  This  OEM  device  was  selected  because  it 
has  a  separate  graphics  processor  with  memory,  dual  tape  cartridge  units,  and 
an  Intel  8080  microprocessor  main  processor,  that  could  be  modified  and 
programmed  as  required.  Modifications  to  the  HP  2649A  included:  converting 
the  8080  microprocessor  from  software  arithmetic  to  hardware  arithmetic  by 
adding  an  Advanced  Micro  Devices  (AMD)  9511  arithmetic  processing  unit, 
developing  an  interface  board  to  preprocess  loran  data  from  two  loran 
receivers,  receiver  interface  board,  developing  an  interface  board  to  connect 
to  the  ship's  gyro,  and  a  TD  bias  modem  or  box,  replacing  the  large  general 
purpose  keyboard  with  a  small  predefined  keypad,  and  building  a  short  base  for 
the  terminal  to  serve  as  a  cable  junction  box.  The  receiver  interface  board 
contains  an  Intel  8085  microprocessor  and  an  AMD  9511  arithmetic  processing 
unit. 

1.3  Harbor  Chart  Tape  Cartridge  generation: 

a.  All  coordinate  conversion  constants  and  navigational 
reference'  information,  as  well  as  a  mosaic  of  harbor  charts,  are  contained  on 
a  cartridge  which  is,  in  effect,  a  Loran-C  harbor  chart  on  a  magnetic 
medium.  A  single  cartridge  contains  as  many  as  200  of  these  charts, 
representing  about  200  miles  of  river  or  harbor. 

b.  Each  cartridge  contains  an  index  file,  master  files,  and 
detail  files.  The  index  file  contains  a  title  block  and  a  list  of  all  master 
charts  on  the  cartridge.  The  index  file  is  always  displayed  before  the  PILOT 
terminal  begins  the  navigation  mode  and  any  time  the  terminal  is  reset. 

c.  Each  master  file  contains  the  graphics  for  a  master  chart 
showing  8-16  miles  of  track  (a  scale  of  about  1:50,000),  the  area 
transformation  coefficients,  transmitter  coordinates,  and  supplemental  data 
such  as  display  origin,  scale,  and  rotation.  Master  charts  provide  "look 
ahead"  by  showing  the  next  several  way  points  and  the  identity  of  a  few 
prominent  features.  8ecause  master  charts  are  generally  not  large  enough  for 
piloting  in  narrow  channels,  each  master  chart  has  one  or  more  detail  charts 
associated  with  It. 

d.  Each  detail  file  contains  the  graphics  for  a  detail  chart 
showing  1-2  miles  of  track  (a  scale  of  about  1:12,500),  the  TD's,  and  X,Y 
coordinates  of  the  current  way  point,  bearing  angles  to  and  from  the  WP,  and 
supplemental  data.  Detail  charts  provide  a  closer  view  of  the  vessel's 
current  situation,  and  include  many  of  the  fixed  aids  to  navigation  and  the 
outline  of  the  channel  if  applicable. 


e.  The  tape  convert  software  was  developed  to  generate  these 
cartridges.  The  tape  convert  software  replaces  the  PILOT  main  code 
software.  The  procedure  for  generating  these  tapes  is  an  off-line  procedure. 

f.  The  tape  convert  software  requires  a  tape  containing  the 
information  in  ASCII,  which  enables  the  operator  to  change  any  or  all  files 
before  generating  the  on-line  or  object  tape  which  is  used  with  PILOT. 
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2.0  SCOPE. 

a.  This  PILOT  software  design  manual  provides  a  description  of 
the  software  associated  with  the  two  microprocessors  mentioned  In  Sections  1.2 
and  1.3.  The  API -developed  code  will  be  given  considerably  more  coverage  than 
Hewlett -Packard  software,  which  Is  described  in  greater  detail  In  Ref.  1. 

b.  The  description  of  the  APL-developed  software  is  grouped  In 
the  following  ways: 

1.  Main  Processor  Software  (Intel  8080  microprocessor). 

2.  Receiver  Interface  Software  (Intel  8085  microprocessor). 

3.  Tape  Convert  Software  (Intel  8080  microprocessor  for 
main  processor). 

c.  Code  for  the  Intel  8080  and  8085  microprocessors  was  written 
in  the  Intel  8080/8085  assembly  language.  Descriptions  of  the  instruction 
sets  associated  with  these  languages  are  contained  in  Ref.  6 

d.  Development  of  the  code  was  performed  on  an  Intel  MDS-230 
Logic  Development  System.  The  operation  of  the  assembler/1  inker  and 
emulator/analyzer  parts  of  this  system  is  described  in  Refs.  3,  4,  and  5 
respectively. 

e.  The  PILOT  program  developed  software  for  two  different 

microprocessors.  The  software  associated  with  the  main  processor  in  the  HP 
terminal  is  the  PILOT  software.  Another  set  of  software,  Tape  Convert,  was 
developed  for  the  generation  of  tapes  to  be  used  with  the  PILOT  software. 
Tape  Convert  was  also  written  for  the  main  microprocessor  in  the  HP 
terminal.  The  software  associated  with  the  Receiver  Interface  card  is 

referred  to  as  the  REXEC  software.  These  three  sets  of  software  are 
completely  independent. 

2.1  API  Oevelooed  Software: 

2.1.1  Main  Processor  Software: 

The  main  processor  software  or  PILOT  software  receives  time 
differences  (TD's)  from  the  REXEC  software  to  compute  the  vessel's  present 
position  and  speed.  Inputs  from  the  vessel's  gyro  and  from  the  operator  via 
the  keyboard  provide  additional  data  for  the  PILOT  software.  This  software  is 
documented  in  Section  3.0. 

2.1.2  Tape  Convert  Software: 

The  Tape  Convert  software  transforms  ASCII  data  into  object  data 
for  use  during  real-time  navigation  by  the  PILOT  software.  This  software  is 
documented  in  Section  6.0. 
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2.1.3 


REXEC  Software: 


... The  R£XEC  software  communicates  with  at  most  two  receivers  and  the 
PILOT  software.  The  REXEC  software  was  written  to  communicate  with  the 
Teledyne  708  and  Internav  Mark  III  Loran-C  receiver  combination.  The  REXEC 
RE*  *  software  was  written  to  communicate  with  the  Teledyne  708  and  Internav 
Section^o"^  receiver  combination.  These  sets  of  software  are  documented  in 
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PILOT  MAIN  PROCESSOR  SOFTWARE. 


3.1  PILOT  Software: 

a.  The  PILOT  unit  is  developed  around  a  Hewlett-Packard  2649A 
computer  terminal.  This  terminal  has  all  the  basic  parts  required  for  a 
computer  terminal,  i.e.,  keyboard,  display,  and  dual  tape  drives,  plus  an 
extensive  graphics  hardware  and  software  package.  The  PILOT  unit  employs  all 
these  features  in  performing  the  navigation  function.  The  HP  2649A  terminal 
used  is  the  OEM  version  of  the  HP  2648  graphics  terminal.  The  basic  operation 
of  the  terminal  is  described  in  Ref.  2.  The  software  which  was  purchased  with 
the  system  is  documented  in  Ref.  1. 

b.  In  developing  the  PILOT  software,  the  HP  software  was  used  to 
communicate  with  all  I/O  devices.  The  PILOT  software  was  appended  to  the 
existing  HP  software. 

c.  As  documented  in  Ref.  1,  the  HP  software  initializes  the 
terminal  in  anticipation  of  operator  entries  and  then  remains  in  a  wait-loop 
until  the  operator  takes  some  action  on  one  of  the  I/O  devices.  The  PILOT 
software  permits  the  HP  software  to  Initialize  the  terminal.  When  the  HP 
software  enters  the  wait-loop,  control  Is  shifted  permanently  to  the  PILOT 
software.  This  is  accomplished  by  modifying  the  HP  code. 

d.  Although  the  PILOT  software  is  in  control  of  the  terminal, 
the  hardware  interrupts  have  not  been  altered.  As  a  result,  the  HP  code  is  in 
control  of  the  interrupts  and  interrupt  structure. 

3.1.1  PILOT  Memory  Organization: 

a.  The  HP  2649A  computer  terminal  has  64K  bytes  of  addressable 
memory  space.  The  PILOT  program  has  divided  this  memory  into  8K  of  RAM  and 
56'<  of  EPROM.  Of  the  56K  bytes  of  EPROM,  40K  are  HP  code  and  16K  are  PILOT 
code  (see  Fig.  3-1).  The  PILOT  code  has  been  divided  into  eight  2K  blocks. 
The  eight  PILOT  blocks  are  PILOT,  UTIL,  NUCR3,  NUCR4,  TDXFM,  NUCR,  NUCR2,  and 
HKBD. 


b.  Each  2K  block  of  PILOT  software  represents  an  independent  set 
of  software.  All  2K  blocks  have  the  ability  to  use  any  or  all  of  the  vari¬ 
ables  located  in  the  common  variable  area,  HCOM.  Each  2K  block  of  software  is 
linked  independently  of  all  other  blocks.  The  entry  vector  technique  is  used 
to  reference  software  not  contained  within  the  same  block  (see  Section  3.1.3). 
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FIGURE  3-1.  PILOT  MEMORY  MAP 


3.1.2 


PILOT  Software  Structure: 


a.  The  PILOT  software  is  structured  so  that  the  executive 
routine,  EXEC,  is  the  main  program.  EXEC  is  the  routine  to  which  the  HP  code 
jumps  after  setting  up  the  terminal  and  it  remains  there  permanently. 

b.  Although  no  hardware  interrupts  have  been  altered,  the 
routine  which  services  the  keyboard  interrupt  has  been  changed  to  permit  the 
PILOT  keyboard  routine,  H<D£C,  to  be  called.  HKDEC  sets  flags  to  indicate 
what  action  is  to  be  taken  by  the  PILOT  executive. 

c.  The  keyboard  used  in  the  PILOT  unit  is  a  smaller  version  of 
the  HP  keyboard.  All  HP  keyboard  codes  were  used  in  the  final  PILOT  system. 
To  service  keys  during  operation  a  keyboard  monitor  routine,  HKBD,  is  used. 
Calls  to  this  routine  are  made  throughout  the  PILOT  executive  to  service 
keyboard  entries. 


d.  The  HP  graphics  package  requires  time  to  update  the  graphic 
display  in  order  to  handle  all  the  graphics  options.  The  keyboard  monitor 
also  performs  this  function. 

3.1.3  PILOT  Entry  Vectors: 

a.  A  segment  of  memory  at  the  beginning  of  each  2K  block  is 
reserved  for  the  definition  of  an  absolute  address  of  a  routine  which  is  used 
outside  that  block.  The  entry  vector  technique  is  used  to  reference  software 
not  contained  within  the  same  block. 

b.  Two  routines  exist  for  each  2K  block.  One  defines  the  entry 
vectors  within  the  block  and  the  other  provides  a  definition  that  other  blocks 
can  use.  To  use  a  routine  outside  a  block,  link  the  entry  vector  definition 
to  satisfy  the  external  reference.  When  the  code  is  executed,  the  entry 
vector  is  transparent  to  the  operation  of  the  software. 

c.  Table  3-1  lists  those  routines  In  each  2K  block  which  provide 
entry  vector  definitions,  entry  point  definitions,  and  links  to  routines  in 
the  Indicated  blocks  of  code. 

3.2  Hewlett-Packard  Code  Modifications: 

3.2.1  Hewlett-Packard  2648  Graphics  Code  Without  Autoplot: 

a.  The  HP  2649A  terminal  used  on  the  PILOT  program  has  an  exten¬ 
sive  graphics  package.  The  autoplot  feature  of  the  graphics  package  is  not 
required.  A  version  of  the  code  without  this  feature  was  obtained  from  HP. 
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TABLE  3-1.  ENTRY  VECTOR  AND  ENTRY  POINT  DEFINITIONS  AND  LINKS. 


ROUTINE 
{ 2K  Block) 

Entry  Vector 
Definition 

Entry  Point  Definitions  and  Links. 

PTEV 

PILOT 

EXEC,  TDFC,  TDBOUT,  MDRT,  TDD,  ESP,  EFER, 
EXLOOP,  and  MDRT. 

PTEVO 

PILOT 

PTEVD  is  linked  to  any  block  using  routines  in 
the  PILOT  block. 

UEV 

UTIL 

LDMP1,  LDMP2,  STMP,  MDRDY ,  ZRMP,  DEGRAD, 
RADDEG,  ESCI,  ESCS,  SQRX,  FXSQRX,  XFER,  ASCFP, 
HYPON1,  HYPON2,  ATANI,  ATAN2,  TRIG,  EREX, 
DFASC,  ASCOF ,  RWCRT,  CRTRW,  DEGRDN,  ASCSF, 
STMP2,  NEWWPT,  and  WPXY. 

UEVO 

UTIL 

UEVO  is  linked  to  any  block  using  routines  in 
the  UTIL  block. 

NU3EV 

NUCR3 

BGON,  BGOFF ,  BLON1,  BLON2,  HDGFIL,  GCP,  IRA6, 
RAB,  ERAS,  IRABL,  STAT,  VESDIM,  PROJ,  PROJI, 
PROJX,  and  EREXP. 

NU3EVO 

NUCR3 

NU3EVD  is  linked  to  any  block  using  routines 
in  the  NUCR3  block. 

NU4EV 

NUCR4 

MPER,  ERC,  HEXASC,  TDER,  TDDER,  TER,  BER, 
TDAER,  BG,  HDGINP,  XYSSET,  MAP,  DISDEL, 

NRWCOR,  NEWCDO,  MPRDY2,  ASCFIX,  INOEX,  LPTOUT. 

NU4EV0 

NUCR4 

NU^EVD  is  linked  to  any  block  using  routines 
in  the  NUCR4  block. 

TDEV 

TOXFM 

TDXFM,  TDTXYl,  FPASC,  TRNF,  XMOVO,  XMOVOP. 

TDEVO 

TDXFM 

TDEVD  is  linked  to  any  block  using  routines  in 
the  TOXFM  block. 

NCEV 

NUCR 

ATCTO,  ATCTS,  TIMTGO,  ANLABL ,  ANVARS  PROUTH, 
PROUT,  PCRLF,  CATCT,  UNPAC,  REPAC,  TDADD,  and 
DSPDAT. 

NCEVD 

NUCR 

NCEVD  is  linked  to  any  block  using  routines  in 
the  NUCR  block. 

NCSEV 

NUCR2 

STMU,  VESSIM,  VESSIN,  STUP,  RDNDEG,  TDSP,  and 
SFASC. 

NCSEVO 

NUCR2 

NCSEVO  is  linked  to  any  block  using  routines 
in  the  NUCR2  block. 

HKEV 

HKBD 

HKBD,  BUFC,  VESSCL,  VESDRW,  and  VESSYM. 

HKEVO 

HK30 

HKEVD  is  linked  to  any  block  using  routines  in 
the  HKBD  block. 
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b.  The  software  math  package,  which  is  part  of  the  autoplot 
feature  contained  in  the  HP  graphics  code,  was  not  required  by  the  PILOT 
program.  To  eliminate  the  software  math  package,  the  code  from  address  8800  H 
thru  8FFF  H  is  deleted  and  the  code  at  addresses  6318  H,  631C  H,  and  6310  H  is 
changed  to  0  H. 


I 


1 


3.2.2  OATCf  Module;  The  data  communications  segment  of  the  HP  software 
is  not  required  by  the  PILOT  software.  In  the  HP  2649A  terminal,  the  entire 
64K  of  memory  is  used  by  the  software  shipped  with  the  terminal.  To  accommo¬ 
date  PILOT  software,  unused  portions  of  the  HP  software  were  eliminated. 
OATCF  is  a  software  patch  which  replaces  the  data  communications  segment  for 
PILOT  software  in  the  HP  terminal.  HP  Data  Communication  software  resides  in 
memory  locations  5000  H  to  5FFF  H.  OATCF  resides  in  memory  locations  5000  H 
to  520B  H  and  leaves  memory  locations  520C  H  to  5FFF  H  available  for  PILOT 
software,  which  equals  3572  available  bytes. 

3.2.3  RAM  Allocation:  The  HP  2648  software  has  16K  bytes  of  RAM  in¬ 
stalled.  The  PILOT  program  requires  only  8K  of  RAM,  4K  for  HP  code  and  4K  for 
PILOT  code.  To  convert  the  unused  8K  of  RAM  to  ROM  the  following  addresses 
were  changed:  156  H  to  EF  H,  158  H  to  EO  H,  and  169  H  to  E3  H. 

3.2.4  Keyboard  Decoding: 

a.  The  PILOT  unit  does  not  use  the  full  keyboard  provided  by  the 
HP  2649A.  A  smaller  keyboard  is  used  which  has  only  23  keys.  The  PILOT 
keyboard  does  not  require  the  same  keyboard  decoding.  The  PILOT  keyboard  uses 
only  upper  case  characters  which  requires  that  address  482C  H  be  changed  to  A7 
H.  The  PILOT  keyboard  has  redefined  the  HP  keys.  To  accommodate  the  redefi¬ 
nition  of  keys  the  following  addresses  were  changed: 


AOORESS 

NEW  VALUE 

ADORESS 

NEW  VALUE 

483C  H 

70  H 

4880  H 

31  H 

483 D  H 

24  H 

4881  H 

FO  H 

4841  H 

FO  H 

48B8  H 

A3  H 

4844  H 

22  H 

4889  H 

FI  H 

4849  H 

FI  H 

48BE  H 

54  H 

484C  H 

58  H 

48C0  H 

33  H 

4840  H 

26  H 

48C1  H 

F2  H 

484 E  H 

74  H 

48C6  H 

59  H 

4851  H 

F2  H 

48CS  H 

A4  H 

4856  H 

79  H 

48C9  H 

F3  H 

4859  H 

F3  H 

48CE  H 

55  H 

485E  H 

75  H 

4800  H 

35  H 

4861  H 

F4  H 

4801  H 

F4  H 

4866  H 

69  H 

4806  H 

49  H 

4869  H 

F5  H 

4808  H 

A2  H 

4871  H 

F6  H 

4809  H 

F5  H 

4879  H 

F7  H 

48E0  H 

37  H 

4880  H 

2E  H 

48E1  H 

F6  H 
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AOORESS 

NEW  VALUE 

ADDRESS 

NEW  VALUE 

4885  H 

40  H 

48E8  H 

A1  H 

4889  H 

88  H 

48E9  H 

F7  H 

4880  H 

28  H 

48F0  H 

2E  H 

488E  H 

72  H 

48F8  H 

39  H 

4891  H 

38  H 

48F9  H 

88  H 

4896  H 

65  H 

48FE  H 

52  H 

4899  H 

8C  H 

4901  H 

88  H 

489E  H 

77  H 

4906  H 

45  H 

48A6  H 

71  H 

4908  H 

2D  H 

4909  H 

SC  H 

490E  H 

57  H 

4916  H 

51  H 

b.  The  HP  keyboard  is  serviced  by  a  10-millisecond  interrupt  to 
determine  if  the  operator  has  hit  any  keys.  The  10-millisecond  interrupt  is  a 
precise  frequency  and,  therefore,  is  an  excellent  source  for  driving  a  clock 
routine.  The  HP  code  is  changed  to  call  the  PILOT  clock  routine  TIMER.  The 
following  addresses  were  changed:  8F2  H  to  33  H  and  8F3  H  to  D8  H. 

3.2.5  Wait-Loop  Control:  In  normal  operation  the  HP  2648  code  initial¬ 
izes  the  terminal  and  then  enters  a  wait-loop.  From  the  wait-loop  the  code 
can  respond  to  any  operator  conmands  or  hardware  interrupts.  The  HP  code  has 
been  changed  so  that  when  the  wait-loop  is  entered,  control  passes  to  the 
PILOT  code  by  jumping  from  the  wait-loop  to  the  PILOT  code.  The  following 
addresses  were  changed  to  accommodate  this  feature:  2A6  H  to  30  H  and  2A7  H 
to  50  H. 

3.3  PILOT  Variables  and  Constants: 

3.3.1  HCOH  Module:  No  calls  are  made  to  HCOM,  only  references  through 
external  statements.  HCOM  contains  all  variables  used  in  the  PILOT  software. 

3.3.2  HCOMF  Module:  Certain  constants  are  used  in  various  locations  by 
the  PILOT  software,  and  rather  than  define  a  constant  every  time  it  is  needed, 
HCOMF  defines  all  constants.  Whenever  a  constant  is  needed,  it  is  referenced 
by  the  name  given  in  HCOMF.  No  calls  are  made  to  HCOMF. 

3.4  Keyboard: 

3.4.1  PILOT  Keyboard  Code: 

a.  The  PILOT  keyboard  uses  HP  code  <ind  code  written  for  the 
PILOT  keyboard.  The  HP  code  performs  the  hardware  task  of  determining  when 
the  operator  hits  a  key.  The  code  written  for  the  keyboard  enables  the 
operator  to  command  the  PILOT  to  turn  ON  or  OFF  the  various  PILOT  options. 

b.  Figure  3-2  summarizes  the  operation  of  the  keyboard  using  a 
state  diagram.  Using  the  keyboard,  the  operator  can  enable  a  particular 
function,  including  specifying  any  quantities  needed,  or  turn  OFF  a  particular 
function.  Should  a  mistake  be  made,  the  entire  entry  can  be  cleared. 
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FIGURE  3-2.  PILOT  KEY80ARD  STATE  DIAGRAM 


3.4.2  HKBD  -  Main  PILOT  Keyboard  Decoding  Module:  The  keyboard  code 

uses  HK30  to  do  the  main  decoding.  HKSD  uses  the  flags  as  defined  in 
Table  3-2  to  determine  the  state  of  the  keyboard  and  then  takes  the  correct 
action.  Whenever  a  key  is  hit,  as  determined  by  HP  code,  HKBD  is  called  (see 
Fig.  3-3). 


FLAG 

CMD 

CMDE 

CF 

FCF 

C3 

CBF 

SHF 

STAF 

PuF 

MSTF 

PF 


TABLE  3-2.  KEYBOARD  FLAGS. 

DEFINITION 

Indicates  which  function  to  perform. 

When  equal  to  CMD  indicates  the  function  is  to  be  executed. 

When  equal  to  FCF  indicates  the  function  is  to  be  cleared. 

Indicates  the  operator  is  in  the  process  of  clearing  a  function. 

Indicates  which  function  to  clear. 

Indicates  the  command  buffer  is  to  be  cleared. 

When  equal  to  CB  indicates  the  command  buffer  is  to  be  cleared. 

Keyboard  shift  flag. 

Indicates  that  the  STATUS  menu  is  displayed  and  that  the  status 
prompt  is  displayed. 

Indicates  which  project  is  in  effect. 

Indicates  if  the  Master  or  Detail  is  displayed. 

Indicates  if  number  keys  are  allowed. 


3.4.3  DSF  -  Display  of  Function  Name  Selected  by  Operator:  If  a  func¬ 
tion  name  is  to  be  displayed,  DSF  is  called.  DSF  decodes  the  keyboard  entry 
and  displays  the  corresponding  function  name  in  the  keyboard  display  buffer. 
HK3D  calls  DSF  whenever  the  function  name  is  to  be  displayed  (see  Fig.  3-4). 

3.4.4  PRNU  -  Numeric  Key  Processor:  PRNU  handles  the  processing  of 
numeric  keys.  HKBO  calls  PRNU  whenever  a  numeric  key  is  a  valid  entry.  PRNU 
displays  the  character  in  the  keyboard  display  buffer  and  saves  the  key  in  a 
buffer  for  execution  of  the  command.  Figure  3-5  is  a  flowchart  of  this 
routine. 

3.4.5  DISFCF  -  Clear  Display:  HKBD  calls  DISFCF  whenever  clear  is 
displayed  and  the  operator  has  selected  the  function  to  be  cleared.  DISFCF 
disdays  the  function  name  to  be  cleared  in  tne  keyboard  disolay  buffer. 
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FIGURE  3-3.  PILOT  KEY80ARD  CONTROLLER/DECODER 


3.4.6  OCF  -  Clear  Display  in  Keyboard  Display  Buffer:  DCF  displays 
clear  in  the  keyboard  display  buffer  whenever  called  by  HKBD.  DCF  checks  CMD 
to  determine  if  clear  is  to  be  displayed  in  the  beginning  of  the  buffer  or 
after  a  function  in  the  buffer. 

3.4.7  BUFC  -  Clear  Keyboard  Display  Buffer:  BUFC  is  called  by  HKBD 
whenever  the  keyboard  display  buffer  is  to  be  cleared,  and  also  resets  all 
keyboard  flags. 

3.4.8  MCOEC  -  Keyboard  Decoder:  The  PILOT  keyboard  code  sets  various 
flags  to  determine  what  action  the  PILOT  software  is  to  take.  HKDEC  decodes 
the  keyboard  flags  and  sets  the  zero  and  carry  flags  to  determine  what  action, 
if  any,  is  to  be  taken.  The  C  register  contains  the  keyboard  value  of  a 
function  on  entry  to  HKDEC. 

3.5  Routine  TIMER: 

3.5.1  Real-Time  Interrupt: 

a.  Routine  TIMER  is  an  interrupt  driven  real-time  clock  routine, 
which  assumes  a  100  Hz  rate  and  provides  time  of  day  (in  hundredths  of  sec¬ 
onds,  seconds,  minutes,  hours)  and  day  of  year.  It  requires  an  external  six- 
byte  memory  array  (named  HSEC)  for  storage. 

b.  All  data  are  stored  in  binary  form  with  day  of  year  requiring 
two  bytes.  Day  of  year  is  therefore  a  16-bit  word,  where  only  the  LS  bit  of 
the  MS  byte  is  actually  used.  The  count  will  go  from  (365-23-59-59-99)  10  to 
( 01-00-00-00-00) with  no  provision  for  leap  years. 

c.  Initialization  of  the  six-byte  memory  array  (current  time)  is 
the  responsibility  of  the  operator.  Executive  time  is  variable;  i.e.,  the 
subroutine  will  return  to  program  control  after  the  last  sequential  parameter 
(1/100 * s  of  a  second,  second,  etc.)  update. 

3.5.2  GCP  -  Graphic  Cursor  Update:  The  graphic  cursor  position  (GCP)  is 
used  as  a  reference  point  for  locating  the  vessel  on  the  display.  GCP  updates 
the  position  of  the  graphic  cursor  using  HP  software.  GCP  is  called  by  the 
executive  to  maintain  the  position  of  the  graphic  cursor. 

3.6  Executive: 

3.6.1  PILOT  Executive: 

a.  The  PILOT  software  consists  of  two  basic  parts:  initiali¬ 
zation  and  navigation  loop.  The  PILOT  unit  remains  in  the  initialization  mode 
until  the  operator  instructs  the  unit  to  "start  navigation."  At  that  time  the 
unit  is  placed  in  the  navigation  loop  permanently  or  until  the  operator 
restarts  the  unit. 


3-12 


J 

I 

r  • 


a 


b.  The  PILOT  executive,  EXEC,  is  the  program  which  is  jumped  to 
from  the  HP  wait-loop.  The  PILOT  executive  is  the  main  controller  and 
decision  maker  of  the  total  PILOT  software  package.  A  functional  block 
diagram  of  the  executive  is  shown  in  Fig.  3-6.  Figure  3-6  is  to  be  used  in 
connection  with  the  detailed  flow  charts  shown  in  Figs.  3-7  through  3-20. 

c.  The  detailed  flow  charts  accurately  describe  the  PILOT 
executive.  Thq  conventions  used  in  the  flow  charts  are:  the  names  within 
brackets [  ]  refer  to  variables  and  names  within  parentheses  (  )  refer 
to  subroutine  names. 

3.6.2  MDOIS  -  Display  of  Background  Graphics:  Whenever  the  background 
graphics  on  the  PILOT  display  is  updated,  MOOIS  performs  the  update  func¬ 
tion.  MODIS  examines  the  master-detail  flag  to  determine  which  set  of 
graphics  to  display.  The  desired  background  graphics  is  then  displayed,  and 
the  variables  that  located  this  display  in  the  real  world  are  also  updated. 
The  scale,  rotation  angle,  and  X  and  Y  coordination  of  the  display  are  updated 
to  reflect  the  values  associated  with  the  display.  MODIS  is  used  to  display 
the  background  graphics  on  initial  turn-on,  whenever  the  operator  toggles  from 
the  master  chartlet  to  the  detailed  chartlet,  or  from  the  detailed  chartlet  to 
the  master  chartlet.  MOOIS  also  turns  off  such  features  as  zoom  and 
range/bearing. 

3.6.3  Tape  Handlers: 

3. 6. 3.1  Updating  Master-Detail  File  Information: 

3. 6. 3. 1.1  Routine  MOU:  MOU  updates  the  master  and  detailed  chartlet  infor¬ 
mation  in  memory  by  reading  a  master  and  detail  file  from  tape.  MOU  uses  MDRT 
to  perform  the  actual  reading  from  tape  of  the  master  and  detail  files.  MOU 
assumes  that  PILOT  has  reached  the  previous  trip  point  and  handles  all  the 
necessary  updating  after  reading  the  files  from  tape.  DU  is  an  entry  point 
into  MOU  for  only  updating  the  detailed  chartlet  information. 

3. 6. 3. 1.2  Routine  MORT:  MDRT  locates  the  file  number  given  in  the  accumu¬ 
lator  and  reads  the  file  into  the  address  contained  in  the  HL  register  pair. 
MORT  uses  RAF  to  perform  the  actual  tape  reading  function. 

3.6.4  HPI  -  Hewlett-Packard  2649A  Initialization:  The  standard  HP  code 
performs  the  initialization  of  the  HP  2649A  terminal.  The  terminal  is  left  in 
a  ready  state  from  which  the  operator  can  perform  any  task.  The  PILOT  soft¬ 
ware  takes  control  of  the  code  at  this  point.  HPI  is  called  to  clear  the  CRT 
and  turn  off  the  alphanumeric  cursor. 

3.6.5  Status: 

a.  When  the  status  display  is  on,  changes  can  be  made  to  the 
status  menu  by  hitting  the  STATUS  key,  entering  the  appropriate  data,  and  then 
hitting  the  EXECUTE  key.  After  this  sequence  has  occurred,  the  PILOT  execu¬ 
tive  calls  subroutine  STUP  to  decode  the  status  menu  input  buffer  and  update 
the  selected  status  variable. 
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b.  The  status  input  data  is  stored  in  buffer  K8UFA.  The  data 
appears  in  the  following  format: 

PPSOO  ...  ODE 

where  P  is  the  two-digit  parameter  number,  S  is  a  space  character,  0  are  the 
data  characters,  and  £  is  an  end  of  page  character. 

c.  When  STUP  is  called,  buffer  K8UFA  already  contains  the  status 
input  data  in  the  above  format.  STUP  will  first  decode  the  parameter  number, 
and  then  process  the  entered  data.  If  an  illegal  parameter  number  is  entered, 
or  if  an  illegal  data  string  is  entered  for  the  given  parameter,  then  STUP 
will  return  without  changing  the  status  menu.  When  a  correct  entry  is  made, 
STUP  will  change  the  given  status  variable  and  take  any  other  appropriate 
action. 


d.  Figure  3-21  shows  the  nine  status  menu  parameters  that  can  be 
changed  by  the  operator.  Time  data,  parameter  10,  must  be  entered  as  hours 
(one  or  two  digits),  then  a  decimal  point,  followed  by  minutes  (one  or  two 
digits).  If  only  hours  is  entered,  and  no  decimal  point  or  minutes  following, 
then  the  minutes  will  be  set  to  zero.  The  way-point  file  number,  parameter 
20,  is  entered  as  a  one  to  three  digit  number.  The  three  TO  bias  numbers, 
parameters  31,  32,  and  33,  are  entered  as  a  sign  character  (no  sign  for  a 
positive  number)  followed  by  a  one-  to  four-digit  number.  The  TD  bias  data  is 
also  output  to  the  hardware  after  being  decoded. 

e.  The  four  flags,  project  (parameter  40),  filter  (parameter 
50),  print  (parameter  60),  and  test  (parameter  70)  are  entered  as  a  one-digit 
number  which  cannot  be  greater  than  three.  STUP  will  change  the  filter  con¬ 
stants  if  the  filter  flag  is  changed.  Changing  the  test  number  will  cause  the 
appropriate  test  procedure  to  be  executed. 

3. 6. 5.1  STMU  -  Status  Menu  Oisplay  Orive: 

a.  The  status  menu  is  output  to  the  terminal  display  by  calling 
subroutine  STMU.  STMU  is  the  driver  subroutine  which  calls  the  six 
subroutines  that  format  and  display  the  data  for  the  three  status  menu  groups. 

b.  STMU  calls  subroutines  STMUAD,  STMU 80,  and  STMUCD  which 
convert  the  status  menu  data  for  groups  A,  8,  and  C,  respecti vely,  into  ASCII 
and  store  it  in  the  appropriate  variables.  The  remaining  subroutines  des¬ 
cribed  below  perform  various  ASCII  conversion  functions,  and  are  called  by 
STMUAO,  STMUBO,  and  STMUCD. 

c.  STMU  also  calls  subroutines  STMUA,  STMUB,  and  STMUC  which 
output  the  status  menu  data  for  groups  A,  B,  and  C  to  the  terminal  display. 
These  three  subroutines  are  described  in  Sections  3. 6. 5. 2  through  3.6. 5.4  and 
Fig.  3-22. 


d.  STMU  does  not  output  the  status  menu  time  of  day  data.  This 
is  performed  by  calling  subroutine  TDSP,  which  formats  and  displays  the  time 
of  day  data  in  the  upper  right-hand  corner  of  the  screen.  STMU  does  display 
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the  fixed  TIME  label  every  time  it  is  called.  The  PILOT  executive  calls  STMU 
and  TOSP  to  display  the  status  menu  and  the  time  of  day  data.  The  fixed  data 
in  the  status  menu  is  only  output  when  the  initialization  flag  (INITF)  is  not 
zero. 


3.6. 5.2  STMUAD  -  Status  Menu  Group  A  Data:  STMUAD  converts  status  menu 
group  A  data  into  ASCII.  The  ASCII  data  are  stored  in  data  tables  STV1  and 
TMS1.  STMUAD  is  called  by  STMU. 

3. 6. 5. 3  STMUBO  -  Status  Menu  Group  B  Data:  STMUBD  converts  status  menu 
group  B  data  into  ASCII.  The  ASCII  data  are  stored  in  data  table  TD1.  The 
heading  angle  is  rounded  off  to  the  nearest  0.1  degree.  STMUBD  is  called  by 
STMU. 

3. 6. 5. 4  STMUCD  -  Status  Menu  Group  C  Data:  STMUCD  converts  status  menu 
group  C  data  into  ASCII.  The  ASCII  data  are  stored  in  data  table  TMS1. 
STMUCD  is  called  by  STMU. 

3. 6. 5. 5  SFASC  -  Single  Fixed  to  ASCII  Conversion:  SFASC  converts  single 
fixed-point  binary  data  (2  bytes)  into  ASCII.  The  number  of  characters  de¬ 
sired  in  the  ASCII  buffer  is  an  entry  variable.  Leading  spaces  are  added  to 
the  ASCII  buffer.  The  single  fixed-point  number  is  assumed  to  be  positive. 

3. 6. 5. 6  B2ASC/B3ASC  -  Binary  Fixed  to  ASCII  Conversion;  B2ASC/B3ASC 
converts  a  one-byte  binary  number  into  ASCII.  B2ASC  generates  two  ASCII 
characters,  while  B3ASC  generates  three  ASCII  characters.  Leading  spaces  are 
added  to  the  ASCII  buffer. 

3. 6. 5. 7  SGDOP  -  Format  GOOP  Data  for  Status  Display:  SGDOP  converts  one 
floating-point  GOOP  number  into  the  correct  ASCII  format  for  the  status  dis¬ 
play.  The  GOOP  format  consists  of  one  integer  character,  an  end-of-page 
character,  two  fractional  characters,  and  an  end-of-page  character.  SGDOP  is 
called  by  STMUCD. 

3. 6. 5. 8  D1ASC  -  Convert  1  BCD  Character  to  ASCII:  D1ASC  converts  one  BCD 
character  into  ASCII.  No  check  is  made  for  illegal  BCD  characters.  D1ASC  is 
called  by  STMUAD. 

3. 6. 5. 9  D4ASC  -  Convert  4  BCO  Characters  to  ASCII:  D4ASC  converts  four 
BCD  characters,  plus  a  sign  (5  bytes)  into  ASCII  (5  characters).  The  8CD  data 
consist  of  a  sign  byte  (0splus,  l*minus),  followed  by  four  BCD  characters  with 
the  most  significant  character  first.  Each  BCD  character  is  contained  in  one 
byte.  If  the  BCD  data  are  positive,  a  space  is  stored  in  the  ASCII  buffer 
sign  location.  Leading  zeros  are  blanked  in  the  ASCII  buffer.  D4ASC  is 
called  by  STMUAD. 

3.6.5.10  STEPP  -  Store  End-of-Paqe  Character;  STEQP  stores  an  end-of-page 
character  at  the  location  indicated  by  register  pair  DE.  The  end-of-page 
character  *  CEH.  Increment  register  pair  DE. 
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3.6.5.11  STSPC  -  Store  Space  Character:  STSPC  stores  a  space  character  (20 
H)  at  the  location  indicated  by  register  pair  OE.  Increment  register  pair  OE. 

3.6.6  TOSP  -  Oisplay  Time-of-Oay  on  Screen:  TDSP  converts  the  time-of- 
day  data  to  ASCII  and  displays  it  on  the  terminal  screen.  TDSP  displays  the 
time  as  HRS.  MIN  in  the  upper  right-hand  corner  of  the  screen.  TDSP  is  called 
by  the  executive. 

3. 6. 6.1  STMUA.  STMUB.  and  STMUC  -  Status  Menu  Groups  A.  B.  and  C.  Rou¬ 
tines  STMUA,  STMUB,  and  STMUC  are  modules  that  paint  the  status  menu  on  the 
CRT  in  the  right-hand  portion  of  the  screen.  The  variables  must  be  in  ASCII 
format  with  certain  required  constant  characters.  STMUA,  STMUB,  and  STMUC 
paint  groups  A,  B,  and  C  portions  of  the  status  menu  (see  Fig.  3-23). 

3.6.7  Input: 

3. 6. 7.1  Receiver  Interface  Communications  in  the  Intel  8080:  There  are 
four  basic  routines  (TDD,  TDIDEN,  TDFC,  and  TDIO)  which  handle  the  communi¬ 
cations  between  the  Intel  3080  and  the  receiver  interface.  These  routines  are 
described  in  the  following  sections. 

3. 6. 7. 1.1  TDD  -  Diagnostic  Command  to  Receiver  Interface:  Routine  TDD  sends 
a  diagnostic  command,  the  contents  of  the  accumulator,  to  the  receiver 
interface,  which  places  it  in  one  of  the  diagnostic  modes. 

3. 6. 7. 1.2  TDIDEN  -  Identifying  TP's  to  Receiver  Interface:  Routine  TDIDEN 
sends  the  identifying  TD's  to  the  receiver  interface  after  sending  the  correct 
command  of  10  H.  TDIDEN  uses  the  TD'S  which  were  read  from  the  tape. 

3. 6. 7. 1.3  TDFC  -  Current  Value  of  Filter  Constants  to  Receiver  Interface: 
The  current  value  of  the  filter  constants  is  sent  to  the  receiver  interface  by 
routine  TDFC.  TDFC  examines  FILF  to  determine  which  filter  constants  the 
operator  has  selected,  and  sends  the  command  of  18  H  to  the  receiver  interface 
to  signify  that  new  filter  constants  are  being  sent  and  that  the  TD  filters 
should  be  reset. 

3.6. 7. 1.4  TDIO  -  TD  Exchange  With  Receiver  Interface:  Routine  TDIO  performs 
the  TD  exchange  with  the  receiver  interface,  and  sends  a  command  byte  of  01  H 
to  signal  the  receiver  interface  that  a  TD  exchange  is  to  occur.  The  receiver 
interface  then  sends  its  status,  TD's,  and  TD's  to  the  Intel  8080.  The  Intel 
8080  then  sends  the  tb's  to  the  receiver  interface;  this  exchange  constitutes 
one  data  exchange. 

3. 6. 7. 2  HDGINP  -  Heading  Input  Module: 

a.  HOGINP  inputs,  as  memory-mapped  I/O,  two  data  bytes  from  the 
TD  8IAS  and  HEADING  interface  card  and  converts  the  data  to  a  format  com¬ 
patible  with  other  PILOT  software.  Heading  Information  can  be  supplied  from 
one  of  two  sources:  the  ship's  gyro  or  the  Digicourse  magnetic  compass 
unit.  The  TO  BIAS  and  HEADING  interface  card  formats  the  raw  data  prior  to 
placing  it  into  absolute  address  locations  8600  H  (MSB)  and  8601  H  (LS3).  The 
interface  card  is  designed  to  accept  an  input  from  one  or  the  other  source  and 
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not  both  simultaneously.  The  interface  card  appends  a  string  of  l's  or  0's  in 
the  least  significant  six  or  seven  bits  of  the  16-bit  data  word.  The  appended 
l's  or  0's  are  used  by  HOGINP  to  identify  the  source  of  the  data. 

b.  The  $ynchro-to-digital  data  format  (gyro  input)  consists  of  a 
10-bit  straight  binary  data  field  and  a  6-bit  source  field  of  appended  binary 
l's;  the  data  have  a  6-bit  binary  scaling.  Likewise,  the  Digicourse  format 
consists  of  a  9-bit  straight  binary  data  field  and  a  7-bit  source  field  of 
appended  binary  0's;  the  Digicourse  data  have  a  7-bit  binary  scaling. 

c.  HDGINP  performs  the  following  operations:  two  bytes  are  read 
from  the  interface  card  using  memory-mapped  I/O,  the  source  is  identified;  and 
depending  on  the  data  source,  the  binary  scaling  is  removed  accordingly.  The 
remaining  binary  number  is  converted  to  the  math  pack  floating  -  point  format 
in  navigation  degrees,  and  then  a  degrees-to-radians  conversion  is 
performed.  The  resulting  radian  value  is  stored  in  memory  at  locations  HOG 
through  HDG43.  HDGINP  is  called  directly  by  the  navigation  executive. 

3.6. 7.3  HDGFIL  -  Heading  Filter  Module: 

a.  HOGFIL  computes  the  TD  accelerations  required  by  the  digital 
filter  in  the  receiver  interface  software.  The  digital  filter  uses  the  TD 
accelerations  to  compute  the  LQRAN  time  differences  (TD's)  and  their  rates 
(TD' s) .  HOGFIL  is  called  by  the  navigation  executive  program  once  per 
navigation  cycle. 

b.  HDGFIL  operates  as  follows.  The  vessel  radial  acceleration 
at  the  current  navigation  update  is  computed  as  a  function  of  the  previous 
radial  acceleration,  the  present  vessel  speed,  the  elapsed  time  since  the  last 
update,  and  the  change  in  the  vessel’s  heading  since  the  last  update.  The 
heading  filter  equation  is  given  by: 

AR1  *  ARi-l  +  ciVi/_ti  <4  *  ’4-1 )  '  ARi-l  f  s  ARi-l  +  cK 

ARi  *  radial  acceleration  at  present  time,  t^ 

ARi-I  *  radial  acceleration  at  previous  time,  t^ 
c  *  filter  constant 
V,j  *  vessel's  speed  at  time, 

_t|  *  tj  -  tj.i  *  elapsed  time  since  last  update 
-I  *  measured  heading  at  present  time,  t^ 
measured  heading  at  previous  time,  t^^ 

K  ■  Vi/.t,(.f  -  -tl)  - 

*  change  in  radial  acceleration  from  t^  to  t^ 


.where : 
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c.  The  radial  acceleration,  AR.j,  is  used  to  compute  the 

rectangular  acceleration  components,  X  and  V,  according  to  the  following 
relationships: 

aX  s  X  *  aRi  *  cos  (vf) 


aY  *  Y  »  -aRi  *  sin  (^) 


where: 


ax  *  X  =  acceleration  in  X-direction 

aY  *  V  *  acceleration  in  Y-direction 

„ .  =  vessel’s  "course-made-good"  angle 

aRi  *  just-computed  radial  acceleration. 

The  quantity,  ** ,  the  "course-made-good"  is  a  computed  angle,  whereas  ,ljl  and 
are  measured  angles  taken  from  the  ship's  gyro. 

d.  The  acceleration  components,  ax  and  aY,  are  used  to  compute 
the  TD  accelerations.  The  TD  accelerations  are  given  by: 


where: 


TDA  -  gx(TDA)  ’  ax  *  9y(TDA)  *  ay 
TDB  s  gx(TD8)  "  ax  a  gY(TDB)  aY 
TDC  a  gx(TDC)  *  ax  +  gY ( TDC )  •  aY 


TDj  *  TD  acceleration  of  the  jth  TD,  j  *  A,B,C 


gx(TDj)  »  gradient  of  the  jth  TD  in  the  X-direction,  j  *  A,B,C 


gy(TOj)  *  gradient  of  the  jth  TD  in  the  Y-direction,  j  =  A,B,C 


ax  *  acceleration  in  X-direction 


av  *  acceleration  in  Y-direction, 
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e.  The  program  varibles  have  the  following  names.  AR  and  ARO 
are  used  for  ARi  and  AR.j^,  respectively.  HFKl  is  used  as  the  heading  filter 

constant,  C.  V  is  the  vessel’s  speed,  Vif  and  is  computed  and  stored  by  the 

ATCTS  module.  Time  is  the  variable  associated  with  it..  HDG  is  the  present 

measured  heading,  while  HOGO  is  the  previous  measured  heading,  v1^.  The 

variable  DACCEL  is  used  for  K,  the  change  in  radial  acceleration.  The  accel¬ 
eration  variables  are  AX  and  AY  for  a^  and  ay  respectively.  CMG  is  the 

vessel's  course-made-good  angle.  The  TO  accelerations  are  defined  by  ATDA, 
ATOB,  and  ATOC  for  TDA,  TD8  and  TDC,  respecti vely.  The  gradients  are  given 
by:  GXTDA  and  GYTDA  for  the  TDA  gradients;  GXTDB  and  GYTD8  for  the  TDB  gra¬ 
dients;  and  GXTDC  and  GYTDC  for  the  TDC  gradients.  The  gradient  matrix  is 
stored  on  the  cassette  tape  and  a  new  set  of  values  are  read  in  whenever  a  new 
master  file  is  read  from  the  tape.  All  variables  are  floating-point 
variables. 


f.  The  value  of  K,  the  change  in  radial  acceleration,  is  com¬ 
pared  to  a  threshold  value  to  determine  if  the  vessel  is  turning.  The  thresh¬ 
old  value  is  defined  by  the  variable  TACCEL.  If  the  value  of  K  (=DACCEL)  is 
less  than  or  equal  to  the  threshold  value,  the  TD  accelerations  are  set  to 
zero. 


g.  On  the  first  pass  through  HDGFIL,  the  previous  measured 
heading,  HOGO,  is  set  equal  to  the  present  measured  heading,  HDG. 

h.  The  previous  radial  acceleration,  ARO,  is  set  equal  to  the 
present  radial  acceleration,  AR.  The  TD  accelerations  are  set  to  zero. 

i.  Figure  3-24  shows  how  HDGFIL  operates. 

3.6.8  TD  Bias: 

3. 6. 8. 1  TD  Bias  -  Variable  Transfer  Routines  (TDBI  and  TD80UT):  TDBI  and 
TDBOUT  enable  the  16-byte  transfer  of  TD  Bias  variables  to  and  from  memory. 
The  external  data  access  point  is  def'ned  as  the  address  at  8680  H. 

3. 6. 8. 2  Conversion  Routines: 

3. 6. 8. 2.1  UNPAC/REPAC  -  Conversion  of  2-Bvte  Words  to  5-Byte  Words  and 
Inverse  Operations: 

a.  UNPAC:  Routine  UNPAC  converts  three  2-byte  words  into  three 
5-byte  words.  The  input  format  is: 

SAAABB88 

CCCCDODD 
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where  S  is  a  sign  bit  and  A,  B,  C,  and  0  are  BCO  digits.  The  output  format 
is: 


0000000S 

OOOOOAAA 

OOOOBBBB 

OOOOCCCC 

OOOQDODO 

Input  data  are  stored  in  six  sequential  memory  locations  starting  at  address 
3IAS.  Output  data  are  stored  in  15  sequential  locations  starting  at  address 
(BIAS  +  6). 

b.  REP AC:  Routine  REPAC  performs  the  inverse  operation  of 
UNPAC.  The  input  is  three  5-byte  words  stored  in  15  sequential  memory  lo¬ 
cations  starting  at  (BIAS  +  6).  The  output  is  three  2-byte  words  stored  in 
six  sequential  memory  locations  starting  at  address  BIAS. 

3. 6. 8. 2. 2  TDADD  -  Convert  BCO  to  Binary  and  Store: 

a.  TOADO  operates  on  the  three  time  differences  (TO's):  TDA, 
TOB,  and  TDC.  For  each  TO  a  32 -bit  binary  bias  is  added  to  the  32 -bit  TD  and 
the  sum  is  stored  in  the  original  4-byte  memory  locations.  The  sequence  of 
operations  performed  for  TDA  is  as  follows:  (1)  convert  5-byte  BCD  bias  (4 
data  bytes  plus  sign)  to  a  32-bit  2's  complement  binary  number,  (2)  addition 
of  the  32-bit  2's  complement  binary  number  to  TDA,  and  (3)  storing  the  32-bit 
sum  in  four  sequential  memory  locations  for  TDA.  This  sequence  is  repeated 
for  TD8  and  TDC. 


b.  The  three  5-byte  bias  data  are  stored  in  15  sequential  memory 
locations  starting  at  (BIAS  +  6).  The  three  4-byte  (32  bit)  TD  values  are 
stored  in  12  sequential  memory  locations  starting  with  TDS. 

3.6.9  Transformation: 

a.  The  PILOT  software  which  converts  receiver  TD  values  to  X-Y 
Cartesian  coordinate  values  is  based  on  the  Loran  navigation  transformation 
algorithm  taken  from  Ref.  7.  The  resulting  assembly  language  programs  which 
are  explained  in  the  following  sections  make  use  of  a  new  math  pack  routine 
called  MAP.  The  calculations  and  parameters  used  to  perform  the  transfor¬ 
mation  are  taken  from  a  listing  of  the  FORTRAN  subroutine  CGQD50,  which  is 
also  thoroughly  documented  in  Ref.  7. 

b.  A  summary  of  the  PILOT  transformation  algorithm  taken  from 
Ref.  7  follows: 
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Given: 


Find: 


vector  containing  a  set  of  TD's 

vector  containing  TD  change  rate 

vector  containing  a  set  of  initial  coordinate  values 

function  to  relate  t  and  2 

set  of  coordinates  for  t 
the  rate  at  which  z  is  changing 


Compute: 


MzJ 


W 


*  h<Zn)  s 


Vzo> 


z  a  z. 


1 -l  •  uAr1 

0  00  0 


2l‘  20  +  Lo  (t“V 


For  K  >  2: 


V  2zk-rzk.2'Lo'1(hUk-l)  -h‘zk-2>) 

2  *  Tim  Z(< 

k-*-«  (k  is  actually  limited  to  32) 

Compute  Lk  and  Lk"*  at  the  converged  value  z  =  zk.  Then 
z  »  Lk*lt 


3. 5. 9.1  Transformation  Routines: 

a.  XYSSET :  Routine  XYSSET  stores  reference  file  No.  2  X-Y 
coordinates  for  transmitter  locations  in  appropriate  RAM  locations  to  allow 
for  station  drop  out  compensation.  XYSSET  is  called  by  the  PILOT  executive 
after  reading  reference  file  No.  2. 

b.  TOXFM:  Routine  TDXFM  is  the  executive  entry  point  to  convert 
ownship's  TD's  to  X-Y  coordinates  for  navigation,  calculation  of  ship 
velocity,  and  generation  of  GDOP. 

c.  TDXVAR:  Routine  TOXVAR  sets  up  working  variables  for  use  in 
converting  TO's  to  X-Y  coordinates  of  position  and  sets  graphics  display  to 
indicate  receiver  status.  TOXVAR  is  called  by  the  TDTXY7  module. 

d.  T0TXY2:  Routine  T0TXY2  is  the  TD  to  X-Y  coordinate  conver¬ 
sion  submodule  used  to  calculate  a  new  X-Y  coordinate  position  during  an 
iteration.  It  also  determines  if  minimum  convergence  criteria  are  met  to 
terminate  the  iteration  process. 

e.  TDTXY3;  Routine  T0TXY3  is  the  TD  to  X-Y  coordinate  conver¬ 
sion  submodule  that  calculates  station  arcs  and  TD  estimates  for  the  iteration 
process. 


f.  T0TXY4:  Routine  T0TXY4  is  the  TD  to  X-Y  coordinate 
conversion  submodule  used  to  generate  G  and  A  matrix  elements. 

3. 6. 9. 2  GETARG/PUTARG  -  General  Purpose  Utilities: 

a.  Routine  GETARG:  GETARG  is  a  general  purpose  utility  used  to 
move  data  from  one  source  location  to  destination  by  using  labels  which  follow 
a  subroutine  call.  This  routine  expects  the  HL  register  to  contain  a  pointer 
to  source  addresses  and  the  OE  register  to  contain  a  pointer  to  destination 
addresses.  All  data  Items  are  expected  to  be  4-bytes  long. 

b.  Routine  PUTARG:  PUTARG  is  the  inverse  of  GETARG  and  expects 
the  HL  register  to  contain  pointer  to  destination  addresses  and  the  DE  reg¬ 
ister  to  contain  pointer  to  source  addresses.  All  data  items  are  expected  to 
oe  4-bytas  long. 
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3. 6. 9. 3  XMQVO  -  Transform  Move  Module:  XMOVO  is  a  general  purpose  utility 
module  constituting  part  of  the  TD  transformation  software.  It  moves  four 
bytes  of  data  from  one  location  to  another  in  memory. 

3.6.10  Along  Track  and  Cross  Track  AT  and  CT  Computations: 

a.  ANLABL  -  Alphanumeric  Labels  Module: 

(1)  Routine  ANLABL  generates  the  labels  for  the  display  of 
alphanumeric  navigation  data.  ANLABL  and  ANVARS  are  the  two 
modules  constituting  the  alphanumeric  display  software. 

(2)  The  PILOT  system  provides  an  operator  with  an  alpha¬ 
numeric  display  of  pertinent  navigation  parameters.  These  pa¬ 
rameters  are  the  vessel's  along-track  and  cross-track  distances 
(ATO  and  CTD),  the  along-track  and  cross-track  speeds  (ATS  and 
CTS),  the  time-to-go  (TTG),  and  the  waypoint  and  bearing  to  which 
the  vessel  is  headed  or  from  which  it  is  leaving.  These  data  are 
displayed  on  the  left  side  of  the  CRT  screen. 

(3)  The  alphanumeric  display  consists  of  two  parts:  the 
labels  and  units  for  the  parameters  and  the  actual  values  of  those 
parameters.  The  labels  are  static.  The  parameter  values  are 
variable  and  are  updated  during  each  navigation  cycle.  ANVARS, 
the  other  module,  generates  the  variable  data  to  the  display  and 
is  called  every  navigation  cycle. 

(4)  The  ANLA8L  routine  is  called  once  during  program  in¬ 
itialization  at  start  up  or  reset.  It  places  on  the  CRT  screen 
the  destination  waypoint  and  bearing  angles  (TO,  FROM)  and  the 
labels  and  units  for  the  parameters. 

b.  ANVARS  -  Alphanumeric  Variables  Module: 

(1)  Routine  ANVARS  generates  the  variables  for  the  display 
of  alphanumeric  navigation  data  and  is  called  every  navigation 
cycle. 

(2)  Before  displaying  the  variable  data,  ANVARS  converts  the 
data  from  Its  floating-point  format  into  ASCII  string  format 
suitable  for  display  on  the  CRT.  ANVARS  writes  the  ASCII  string 
representations  of  the  parameters  into  the  alphanumeric  memory. 

c.  ANOSP  -  Alphanumeric  Display  Message  Module: 

(1)  ANOSP  is  a  utility  module  that  writes  an  ASCII  string 
into  the  alphanumeric  display  memory  for  display  on  the  CRT 
screen.  It  is  used  to  place  alphanumeric  data  on  any  location  on 
the  CRT. 


(2)  The  inputs  required  for  ANDSP  are  the  starting  address 
of  the  ASCII  string  and  the  row  and  column  of  where  on  the  CRT  the 
string  will  start.  ANOSP  uses  these  input  parameters  to  setup  for 
the  HP-defined  DSPMSG  subroutine. 

(3)  The  DSPMSG  subroutine  performs  the  actual  string  manip¬ 
ulations  and  data  display  operations.  It  writes  the  ASCII  data 
into  the  proper  locations  of  the  alphanumeric  display  memory. 
Further,  OSPMSG  is  setup  by  ANOSP  to  add  the  message  to  the  normal 
display  rather  than  erasing  the  display.  OSPMSG  assumes  that  the 
ASCII  string  is  terminated  with  an  end-of-page  character  (»  OCEH). 

-  Alonq-Track-Cross-Track  Distance  Module: 


(1)  ATCD  computes  the  along-track  and  cross-track  distance 
(ATD  and  CTD)  navigation  parameters.  It  is  called  by  the 
navigation  executive  during  each  navigation  cycle. 

(2)  The  ATD  and  CTD  parameters  are  described  as  follows: 
the  straight  line  between  the  previous  waypoint  and  the  desti¬ 
nation  waypoint  defines  the  track  line;  and  the  ATD  describes  how 
far  the  vessel  would  be  from  the  destination  waypoint  if  it  were 
on  the  trackline;  and  CTD  describes  how  far  the  vessel  is  from  the 
track  line. 

(3)  ATD  and  CTD  are  computed  in  the  following  manner.  Based 
on  the  received  loran  time  differences  (TO's)  and  the  known  time 
differences  at  the  destination  waypoint,  the  PILOT  system,  using  a 
TD-to-XY  transformation  algorithm,  calculates  the  vessel's  X  and  Y 
coordinates  referenced  to  the  loran  chain  coordinate  system. 

(4)  Since  the  waypoint  coordinates  are  known,  the  vessel -to- 
waypoint  distance  (or  range)  can  be  calculated  using  the  standard 
distance  formula.  The  trackline  makes  an  angle  with  the  north 
line  called  the  "destination  bearing  angle”  (DBA).  The  vessel-to- 
waypoint  line  makes  a  second  angle  with  the  north  line  called  the 
"present  position  bearing  angle"  (PPBA).  If  the  vessel  is  on  the 
trackline,  then  the  two  angles  are  equal.  In  this  case  the  ATD  is 
the  same  as  the  distance  from  the  vessel  to  the  waypoint,  and  the 
CTD  is  zero.  If  the  vessel  is  not  on  the  trackline,  then  a 
differential  angle,  PPBA-DBA,  can  be  computed  which  describes  by 
how  much  the  vessel -to-waypoint  line  is  to  the  right  or  left  of 
the  trackline  and  is  used  to  give  sense  (left  or  right)  to  the  CTD 
value. 

(5)  Thus,  by  computing  the  vessel-to-waypoint  range  and  the 
differential  angle,  ATO  and  CTD  can  be  found  by  trigonometric 
relationship  found  in  the  right  triangle  where  ATD  and  CTD  are  the 
two  sides  and  the  range  is  the  hypotenuse.  ATD  and  CTD  are 
computed  by: 

ATO  »  RA,NGE*C0S(  PPBA-DBA) 

CTD  «  RANGE*S IN (PPBA-DBA) 


ATD  and  CTO  are  in  units  of  floating-point  yards,  since  the 
coordinates  are  in  these  units.  Conversions  to  other  units  are 
performed  in  the  CATCT  module  (see  Section  3.6.10(g)).  Figure 
3-25  illustrates  the  geometry  of  the  along-track  and  cross-track 
distance  (ATD  and  CTD)  computations. 

e.  ATCTS  -  Alonq-Track/Cross-Track  Speed  Module; 

(1)  ATCTS  computes  the  along-track  and  cross-track  speed 
(ATS  and  CTS)  navigation  parameters.  It  is  called  by  the 
navigation  executive  during  each  navigation  cycle. 

(2)  The  ATS  and  CTS  parameters  are  described  as  follows. 
The  straight  line  between  the  previous  waypoint  and  the  desti¬ 
nation  waypoint  defines  the  trackline.  The  vessel's  velocity 
vector,  V,  can  be  resolved  into  two  components  with  respect  to  the 
trackline:  (1)  a  velocity  component  along  the  trackline  and  (2)  a 
velocity  component  normal  to  the  trackline.  ATS  is  the  magnitude 
of  the  velocity  component  along  the  trackline,  and  CTS  is  the 
magnitude  of  the  velocity  component  normal  to  the  trackline. 

(3)  ATS  and  CTS  are  computed  in  the  following  manner.  The 
velocity  is  computed  as  stated  in  Section  3.6.11.  The  velocity 
vector  is  formed  by  the  vector  sum  of  the  X  and  Y  velocity  com¬ 
ponents.  The  vessel  speed  is  found  as  the  magnitude  of  the 
velocity  vector.  The  vector  direction  is  the  angle  which  the 
vector  makes  with  the  north  line.  This  angle  is  called  "course 
made  good"  (CMG).  The  trackline  makes  another  angle  with  the 
north  line  called  the  "destination  bearing  angle"  (DBA).  If  the 
vector  direction  were  parallel  to  the  trackline,  then  the  two 
angles  would  be  equal.  In  this  case  the  ATS  is  the  same  as  the 
vessel's  speed,  and  the  CTS  is  zero;  i.e.,  there  would  be  no 
component  of  velocity  away  from  the  track  line  or  a  line  parallel 
to  it  passing  through  the  vessel.  If  the  vector  direction  is  not 
parallel  to  the  track  line,  then  a  differential  angle,  CMG-DBA,  can 
be  computed  which  describes  by  how  much  the  velocity  vector  must 
be  rotated  to  coincide  with  the  track  line  or  a  line  parallel  to 
it.  The  sign  of  the  difference  angle  describes  whether  the  vector 
points  to  the  right  or  left  of  the  track  line  and  is  used  to  give 
sense  (left  or  right)  to  the  cross-track  speed  value. 

(4)  The  velocity  vector  can  be  resolved  into  two  components 
with  respect  to  the  trackline:  (1)  a  velocity  component  along  the 
trackline  or  a  line  parallel  to  it  and  (2)  a  velocity  component 
normal  to  the  trackline.  ATS  and  CTS  are  the  magnitudes  of  these 
two  velocity  components.  ATS  and  CTS  are  computed  by: 

ATS  *  SPEED*COS(SMG-DBA) 

CTS  *  $PEED*SIN( CMG-DBA) 
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FIGURE  3-25.  ALONG- TRACK/CROSS-TRACK  OlSTANCE  MODULE . 


ATS  and  CTS  are  in  units  of  floating-point  yards  per  second,  since 
the  X  and  Y  velocity  components  are  in  these  units.  Conversions 
to  other  units  are  performed  in  the  CATCT  module  (see  Section 
3.6. 10. (g)).  Figure  3-26  illustrates  the  geometry  for  the  along- 
track  and  cross-track  speed  (ATS  and  CTS)  computations. 

f .  TIMTGO  -  Time  to-Go  Module: 

(1)  Routine  TIMTGO  computes  the  time-to-go  (TTG)  navigation 
parameter.  It  is  called  by  the  navigation  executive  during  each 
navigation  cycle. 

(2)  The  TTG  parameter  describes  approximately  how  long  it 
will  take  the  vessel  to  travel  from  its  current  position  to  the 
destination  waypoint  if  the  along-track  speed  and  heading  are 
maintained.  TTG  is  computed  by  dividing  the  current  along-track 
distance  in  yards  by  the  current  along-track  speed  in  yards  to 
determine  the  time-to-go  in  seconds: 

TTG(SECS)  *  ATD( YDS) /ATS (YDS/SEC) 

TTG  is  in  units  of  floating-point  seconds.  The  CATCT  module 
performs  the  conversion  of  ^G  from  seconds  to  other  units  of 
measure. 

g.  CATCT  -  Alonq-Track/Cross-Track  Parameter  Conversion: 

(1)  Routine  CATCT  converts  the  navigation  parameters  from  an 
internal  set  of  units  to  the  units  required  by  the  operator.  The 
navigation  executive  calls  CATCT  during  each  navigation  cycle. 

(2)  The  vessel's  position  is  computed  as  X  and  Y  coordinates 
in  a  loran  chain  coordinate  system.  The  coordinates  are  in  units 
of  floating-point  yards.  The  velocity  is  computed  as  X  and  Y 
components  given  in  yards  per  second.  Therefore,  the  along-track 
and  cross-track  parameters  are  computed  in  yards  and  yards  per 
second.  However,  the  operator  requires  that  these  parameters  be 
in  more  suitable  units  on  the  display;  e.g.,  yards  or  miles,  miles 
per  hour,  or  minutes. 

(3)  CATCT  converts  the  parameters  in  yards  and  yards  per 
second  to  display  units  suitable  for  the  operator.  Since  the 
along-track  distance  parameter  can  be  displayed  in  yards  or  miles, 
CATCT  determines,  depending  upon  the  magnitude,  which  unit  of 
measurement  is  appropriate  and  sets  a  flag. 

h.  Position.  Cross-Track  Module  -  PCT: 

(1)  PCT  determines  whether  the  vessel  is  to  the  left  or 
rignt  of  the  trackline.  It  is  called  by  the  along-track,  cross¬ 
track  distance  module,  ATCTD,  which  is  called  by  the  navigation 
executive  during  each  navigation  cycle  and  computes  a  differential 
angle. 
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(LORAN  CHAIN  COORDINATE  SYSTEM) 
iw 


(X,  Y):  VESSEL'S  PRESENT  POSITION  COORDINATES 

(XM,  Yn):  DESTINATION  WAYPOINT  (N)  COORDINATES 

(XN_,,  Yn_1):  PREVIOUS  WAYPOINT  (N-1)  COORDINATES 
(X,  Y):  VESSEL'S  X  AND  Y  VELOCITY  COMPONENTS 

V:  VESSEL'S  VELOCITY  VECTOR 

S:  VESSEL'S  SPEED  ■  ((X)2  ♦  (Y)2)'* 

CMG:  "COURSE- MADE-GOOD"  -  TAN’’  (X/Y) 

DBA:  DESTINATION  BEARING  ANGLE 

DIFFERENTIAL  ANGLE  -  CMG— DBA 

ALONG-TRACK  SPEED:  ATS  -  S*COS(CMG-D8A) 
CROSS-TRACK  SPEED:  CTS  •  S»SIN(CMG-DBA> 


FIGURE  3-25.  ALONG- TRACK /CROSS -TRACK  SPEED  COMPUTATIONS 


(2)  The  differential  angle  is  computed  by  subtracting  the 
destination  bearing  angle  (D8A)  from  the  present  position  bearing 
angle  ( PPBA) .  These  angles  are  described  in  Section  3.6.10.  The 
sign  of  the  differential  angle  determines  whether  the  vessel  is  to 
the  left  or  right  of  the  trackline.  PCT  evaluates  the  sign  of  the 
differential  angle,  PPBA-DBA,  and  indicates  on  the  alphanumeric 
display  whether  the  trackline  is  to  the  left  or  right  of  the 
vessel.  The  position  indicator  appears  in  the  CTD  alphanumeric 
line  and  will  be  an  L  or  R  following  the  numerical  value  for  CTO. 

i .  Direction,  Cross-Track  Module  -  OCT: 

(1)  OCT  determines  the  direction  in  which  the  vessel  is 
moving,  left  or  right,  relative  to  the  trackline,  and  puts  this 
information  on  the  alphanumeric  display  on  the  CRT.  It  is  called 
by  the  ATCTS  module,  which  is  called  by  the  navigaton  executive 
during  each  navigation  cycle  and  computes  a  differential  angle. 

(2)  The  differential  angle  is  computed  by  subtracting  the 
destination  bearing,  DBA,  from  the  velocity  vector  heading  angle 
called  "course-made-good1'  (CMS).  Course-made-good  is  defined  as 
the  angle  which  the  velocity  vector  makes  with  a  north line  and  is 
computed  using  the  X  and  Y  velocity  components  of  the  vessel.  The 
angles,  CMG  and  DBA,  are  described  in  Section  3.6.10.  The  sign  of 
the  differential  angle  tells  whether  the  velocity  vector  points 
toward  the  right  or  left  of  the  track  line.  When  it  is  resolved 
into  components  parallel  to  and  normal  to  the  trackline,  the 
direction  of  the  normal  component  points  in  the  cross-track 
direction  in  which  the  vessel  is  moving,  i.e.,  toward  the  right  or 
the  left.  OCT  evaluates  the  sign  of  the  differential  angle,  CMG- 
OBA,  and  indicates  on  the  alphanumeric  display  whether  the  vessel 
is  moving  in  the  right  or  left  cross-track  direction.  The 
direction  indicator  appears  in  the  CTS  alphanumeric  line  and  will 
be  an  ASCII  L  or  R  following  the  numerical  value  for  CTS. 


3.6.11  Velocity  Calculation  -  VC:  The  velocity  calculation  (VC)  used  by 
PILOT  is  a  first -order  filter  based  on  a  change  in  position.  The  equation 
used  is: 


V 


V  (1-K)  +  K 


where 

V  *  velocity 

K  *  constant  less  than  1 

0  *  current  distance 

0Q  «  previous  distance 

_t  *  change  in  time 


VC  uses  this  equation  to  compute  an  X  and  Y  component  of  velocity. 
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3.6.12 


Switching  Control  Module  -  SVII : 


a.  Routine  SWI  determines  when  it  is  necessary  to  bring  a  new 
file  or  files  from  the  cartridge  tape  and  switches  files  before,  at,  and  after 
the  waypoint.  It  is  called  by  the  navigation  executive  during  every 
navigation  cycle. 


b.  A  determination  is  made  by  SWI  if  the  vessel  has  crossed 
along-track  switchpoints  and  sets  flags  accordingly.  The  switchpoints  are 
stored  on  the  cartridge  tape  and  are  brought  in  when  a  file  is  read  in.  The 
tape  contains  two  types  of  switchpoints:  the  master  file  switchpoint  and  the 
detail  file  switchpoint.  SWI  compares  the  magnitude  of  the  completed  along- 
track  distance  values  with  these  switchpoints.  The  sign  of  the  computed 
along-track  distance  is  also  evaluated.  Each  master  file  contains  one  or  more 
detail  files.  If  the  vessel  has  crossed  a  detail  switchpoint,  but  not  the 
master  switchpoint,  then  a  flag  is  set  that  directs  the  navigation  executive 
to  read  in  the  next  detail  file.  If  the  master  switchpoint  has  been  crossed, 
then  a  flag  is  set  that  directs  the  executive  to  read  in  the  next  master  file 
and  its  first  detail  file.  If  along-track  distance  is  negative,  then  the 
vessel  has  crossed  over  a  waypoint  and  is  leaving  it.  SWI  adjusts  the  alpha¬ 
numeric  display  accordingly,  telling  the  operator  that  it  is  leaving  the 
waypoint  at  some  new  bearing  angle.  This  angle  is  the  bearing  to  the  next 
waypoi nt. 


c.  Routine  SWI  accepts  as  input  the  switch  status  flag,  SWIF,  a 
single-byte  variable  stored  in  HCOM,  and  action  is  taken  according  to  the 
information  contained  in  SWIF.  SWI  also  acceots  as  input  the  detail  status 
flag,  DSTAT+1,  also  stored  in  HCOM.  DSTAT+1  is  examined  to  determine  if  the 
present  detail  file  is  also  the  last  one  for  the  present  master  file. 

d.  The  output  provided  by  SWI  is  an  updated  switch  status  flag, 
SWIF,  based  on  which  action  was  taken.  The  navigation  executive  examines  the 
switch  status  flag  to  determine  whether  it  needs  to  read  a  new  file  or  files 
and,  if  so,  which  type  or  types  of  files. 


3.6.13  Line  Printer  and  Tape  Output: 

3.6.13.1  Line  Printer/Tape  Qumo  Module  -  LPTQUT: 

a.  IPTOUT  is  the  module  called  by  the  PILOT  executive  whenever 
output  to  the  line  printer  or  tape  is  enabled. 

b.  LPTOUT  makes  use  of  the  following  utility  routines:  PROUTH, 
PROUT,  PRREC,  PCRLF ,  WAR,  and  WAEOF. 
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3.6.13.2  Header  Module  -  PROUTH:  PROUTH  outputs  the  header  record  to  the 
PILOT  print  buffer  FRB'JF  whenever  it  is  called.  The  header  record  consists  of 
column  headings  in  one  line  and  the  column  units  in  the  next  line. 


3.6.13.3  Oata  Output  Module  -  PRQUT: 

a.  PROUT  outputs  the  data  record  to  the  PILOT  print  buffer  PRBUF 
■whenever  it  is  called. 

b.  The  data  record  consists  of  136  bytes  of  ASCII  data  repre¬ 
senting  the  variables  to  be  output  to  the  printer  or  tape.  PROUT  builds  up 
this  data  record  by  converting  each  variable  from  its  internal  storage  format 
into  its  equivalent  ASCII  string  and  storing  it  in  an  appropriate  location 
within  the  print  buffer. 

3.6.13.4  Print  a  Record  Module  -  PRREC: 

a.  PRREC  is  used  to  send  a  record  of  data  in  the  print  buffer 
PR8UF  to  the  HP  2631G  printer.  The  printer  is  used  to  log  PILOT  data  in  a 
human  readable  form.  The  printer  must  be  "on  line"  if  PRREC  is  to  operate 
correctly. 


b.  The  HP  2649A  terminal's  subroutine  PUTIO  is  used  by  PRREC  and 
performs  all  required  setup  tasks.  PUTIO  is  a  general  purpose  utility  sub¬ 
routine  that  can  transfer  a  record  of  data  to  a  selected  device.  PRREC  re¬ 
ceives  as  input  parameters  the  starting  address  of  the  data  record  and  the 
number  of  bytes  in  the  data  record.  PUTIO  uses  two  buffers  (IOBUF1  and 
I0BUF2)  which  are  256  bytes  long.  The  maximum  byte  count  passed  to  PRREC  in 
the  B  register  is  255.  PRREC  selects  the  HP  2631G  printer  as  the  receiving 
device,  gets  one  of  the  buffers,  and  then  calls  PUTIO.  PUTIO  transfers  the 
data  in  its  buffer  to  the  printer.  PRREC  then  frees  the  PUTIO  buffer  before 
returning  to  the  caller. 

c.  PRREC  assumes  ASCII  data  in  the  data  record  to  be  output  to 
the  printer.  Other  data  formats  have  no  meaning  on  the  printer  listing. 
Since  PRREC  does  not  issue  a  carriage  return  and  line  feed  to  the  printer,  the 
PCRLF  module  accomplishes  these  functions  (see  Section  3.6.13.5). 


3.6.13.5  Printer  Carriage  Return/Line  Feed  Module  -  PCRLF: 

a.  PCRLF  is  a  printer  utility  module  used  to  perform  a  carriage 
return  and  line  feed  on  the  HP  2631G  printer.  The  printer  is  used  as  a  data 
logger  when  the  PILOT  system  is  operating  in  a  navigation  mode. 


ATD  ■  Along  Trick  Oittanca 
MATOS  *  Misttr  Fill  ATO  Switch  Point 
OATOS  *  Oitail  Fill  ATO  Switch  Point 


FIGURE  3-27.  SWITCHING  CONTROL  MODULE  -  SI 


b.  PCRLF  sets  up  ASCBUF  with  ASCII  carriage  return  and  line  feed 
characters  and  then  calls  the  utility  subroutine  PRREC.  PRREC  sends  the  data 
to  the  printer  which  causes  it  to  perform  a  carriage  return  and  a  line  feed. 

3.6.13.6  Tape  Write  Routine  -  WAR: 


a.  WAR  is  called  to  transfer  print  buffer  data  to  the  right  tape 
drive  of  the  PILOT  terminal.  A  tape  must  be  installed  in  the  right  drive  for 
this  routine  to  operate  properly. 

b.  Oata  written  on  tape  has  the  same  format  as  that  written  or 
printed  by  the  line  printer.  The  data  are  stored  as  ASCII  characters. 

3.6.13.7  Tape  Write  End  of  File  -  WAEQF:  WAEOF  is  called  to  write  end-of- 
file  (EOF)  data  on  the  right  tape  drive.  EOF  marks  are  used  to  separate  each 
record  written  on  the  tape. 


3.6.14 


Vessel  S\ 


3.6.14.1  Vessel  Scaling  -  VESDIM:  The  vessel  symbol  displayed  by  PILOT, 
when  using  the  detail  chartlet,  is  scaled  to  the  dimensions  of  the  vessel  on 
which  PILOT  is  installed.  VESDIM  performs  the  scaling  operation  by  reading 
the  three  binary  switches  located  on  the  TD  Bias  and  Heading  Board,  and  con¬ 
verts  each  of  these  switch  readings  into  floating-point  math  pack  numbers  for 
later  use.  The  operator  sets  the  vessel  length,  vessel  width,  and  location  of 
the  antenna  from  the  bow.  Each  binary  switch  consists  of  eight  toggle 
switches.  The  value  of  each  toggle  is  as  follows: 


Length  and  Antenna  (in  feet 


in  feet 


3.6.14.2  Simple  Vessel  Symbol  -  VESSIM:  When  a  master  picture  is  being 
displayed,  VESSIM  draws  a  cross  hair  on  the  CRT  at  the  point  representing  the 
vessel's  position.  The  cross  hair  consists  of  a  half-inch  vertical  line 

intersecting  a  half-inch  horizontal  line.  The  intersection  defines  the 

vessel's  position.  The  cross  hair  is  drawn  in  the  complement  video  mode 

defined  by  the  HP  2649A  terminal.  It  can  be  erased  by  redrawing  it  in  the 

same  mode.  Other  graphics  remain  undisturbed  when  using  the  complement  video 
feature.  The  navigation  executive  determines  if  a  master  picture  is  being 
displayed,  and,  if  so,  will  call  the  VESSIM  subroutine. 


3.6.14.3  Detail  Vessel  Graphic  Software: 


a.  In  contrast  to  the  simple  cross  hair  employed  for  a  master 

picture,  the  vessel  graphics  software  required  for  a  detail  picture  is 

considerably  more  involved. 

b.  The  detail  vessel  graphics  software  performs  the  following 

functions: 

1.  For  each  new  detail  file  it  scales  the  vessel  to  the  CRT 
using  the  vessel  length,  width,  and  antenna  position  as 
input  parameters. 

2.  For  each  navigation  cycle  it  translates  the  vessel 

symbol  to  its  proper  location  on  the  CRT,  rotates  the 
vessel  symbol  to  align  it  with  the  vessel's  heading,  and 
draws  the  vessel  symbol  on  the  CRT. 

c.  The  vessel  graphics  software  consists  of  three  modules: 

1.  VESSCL:  Scales  the  vessel  symbol  to  the  CRT  for  each 

new  detail  file  (when  the  scale  factor  can  change). 

2.  VESSYM:  Translates  and  rotates  the  vessel  symbol  to  its 
proper  position  on  the  CRT. 

3.  VESDRW:  Draws  the  vessel  symbol  in  complement  video 

mode  on  the  CRT. 

3.6.14.4  Vessel  Symbol  Scaling  Module  -  VESSCL: 

a.  VESSCL  is  one  of  three  modules  which  constitute  the  detail 
vessel  symbol  software.  This  module  scales  the  vessel  symbol  to  the  display, 
using  the  detail  scale  factors  of  the  vessel  length,  width,  and  antenna 
position  as  input  parameters.  It  is  called  by  the  navigation  executive 
whenever  a  new  detail  file  is  read  from  the  cartridge  tape.  VESSCL  generates 
as  outputs  five  coordinate  pairs  of  numbers.  These  five  pairs  of  numbers 
define  five  points  representing  the  vertices  of  an  irregular  pentagonal  figure 
as  shown  below: 


(VOX,  VOY) 

(V1X,  VI Y)  /\  (V2X,  V2Y) 

+ 

(V3X,  V3Y)  • - *(V4X,  V4Y) 


This  pentagonal  figure  defines  the  archetypical  vessel  symbol.  The  parameter, 
VESLEN,  determines  the  symbol  length;  the  parameter,  VESWID,  the  width,  and 
the  parameter,  ANTENA,  the  antenna  position.  These  parameters  are  fixed  and 
are  set  at  the  time  of  installation.  The  plus  sign  (+)  identifies  the  antenna 
position. 
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b.  VESSCL  computes  the  X  and  Y  coordinates  of  the  five  points 
relative  to  the  antenna  position.  The  antenna  position  coincides  with  the 
display  origin,  i.e.,  the  lower  left-hand  corner  of  the  CRT  screen.  The  CRT 
coordinate  system  is  defined  so  that  the  Y-axis  coincides  with  the  vessel 
symbol  longitudinal  axis,  and  the  X-axis  intersects  it  at  the  antenna  position 
marking  the  origin  as  illustrated  below: 


(CRT  display) 


XCRT 


The  coordinates  of  the  five  points  are  computed  and  stored  as  32-bit,  float¬ 
ing-point  numbers.  The  conversion  to  CRT  coordinates  (2's  complement,  16-bit 
binary  integers)  occurs  in  module,  VESSYM.  The  five  points  are  identified  as 
ordered  pairs:  (VOX,  VOY),  (V1X,  V1Y),  (V2X,  V2Y),  (V3X,  V3Y),  and  (V4X,  V4Y) . 

3.6.14.5  Vessel  Symbol  Module  -  VESSYM: 

a.  VESSYM  is  one  of  three  modules  constituting  the  detail  vessel 
symbol  software.  This  module  translates  and  rotates  the  vessel  symbol  model 
computed  in  VESSCL.  Whenever  the  displayed  picture  is  a  detail,  VESSYM  is 
executed  once  per  navigation  cycle.  It  is  called  by  the  navigation  executive. 

b.  To  provide  a  graphical  output  to  the  operator,  the  model  must 
be  translated  and  rotated  with  respect  to  the  display  origin,  which  coincides 
with  the  CRT  screen  origin  (the  lower-left  corner)  (see  Fig.  3-28). 

c.  The  inputs  to  VESSYM  include  the  model  coordinates  computed 
in  VESSCL  and  the  current  vessel  position  X,Y  and  heading. 

d.  The  output  of  VESSYM  consists  of  a  set  of  five  ordered 
pairs.  These  five  coordinate  pairs  represent  the  actual  vessel  symbol  to  be 
drawn  on  the  CT,  and  are  designated  as:  (BX,  BY),  (LBX,  LBY),  (RSX,  RBY), 
(LSX,  LSY),  and  (RSX,  RSY)  These  variables  are  2's  complement,  16-bit  binary 
integers  and  are  recomputed  each  time  VESSYM  is  executed. 

3.6.14.6  Vessel  Draw  Module  -  VESDRW: 

a.  VESDRW  is  one  of  three  modules  constituting  the  detail  vessel 
symbol  software.  This  module  draws  the  vessel  symbol  on  the  CRT  in  the 
complement  video  mode.  This  mode,  supplied  as  part  of  the  HP  terminal,  allows 
graphics  images  to  be  drawn  In  such  a  way  that,  when  erased,  other  graphics 
images  are  undisturbed.  Thus,  the  previous  vessel  symbol  is  erased  by  drawing 
it  again  in  the  complement  video  mode  which  leaves  the  background  graphics 
intact.  The  previous  symbol  is  erased  before  new  coordinates  are  computed  for 
the  current  symbol. 


X 


*o 

3  COORDINATE  SYSTEMS: 

1.  X.  Y:  REAL  WORLD  (LORAN  CHAIN)  COORDINATE  SYSTEM 

2.  X1,  Y':  DISPLAY  COORDINATE  SYSTEM, 

ROTATED  SY  ANGLE  9  WITH  RESPECT  TO  X,  Y 

3.  X",Y":  VESSEL  COORDINATE  SYSTEM, 

ROTATED  BY  ANGLE  v  (HEADING)  WRT  X,  Y 

POINTS  WITHIN  COORDINATE  SYSTEMS'. 

1.  (X,  Y):  VESSEL'S  POSITION  WRT  X,Y 

2.  (X0,  Y0):  DISPLAY  ORIGIN  WRT  X,  Y 

3.  (Xd,  Yd):  VESSEL  ROTATION  WRT  X'.  Y' 

RELATIVE  ROTATION: 

(V~(9):  VESSEL  ROTATION  WRT  X',  Y' 

FIGURE  3-23.  VESSYM-COORDINATE  SYSTEMS  AND  ROTATIONS. 
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b.  Inputs  to  VESDRW  are  the  five  pairs  of  CRT  coordinates 
calculated  by  VESSYM  (see  Section  3.6.14.5).  It  outputs  the  vessel  symbol 
image  by  drawing  solid  vectors  in  the  graphics  memory  connecting  the  five 
pairs  of  points. 


c.  Ouring  one  navigation  cycle,  VESDRW  is  called  twice  by  the 
navigation  executive:  to  erase  the  previous  symbol  and  again  after  a  new 
symbol  has  been  computed  by  the  VESSYM  module. 

3.6.15  CTO  BAR: 

3.6.15.1  Bar  Graph  Module  -  BG: 

a.  36  displays  the  bar  graph  and  the  vessel  image  whenever  the 
operator  has  requested  CTD  BAR  via  the  keyboard.  The  B6  module  is  called 
directly  by  the  navigation  executive  whenever  the  bar  graph  display  is  wanted. 

b.  The  bar  graph  display  shows  a  calibrated  distance  scale  and 
the  corresponding  labels  at  the  bottom  of  the  CRT  screen.  Two  scales  are 
currently  implemented:  +100  yards  and  +500  yards.  Angle  brackets  are 
positioned  according  to  channel  width  data  from  the  cartridge  tape.  The  zero 
position  on  both  scales  falls  at  the  middle  of  the  CRT  screen.  Superimposed 
on  the  graph  and  presented  in  Inverse  video  is  a  scaled  vessel  image  field. 
This  field  is  positioned  on  the  graph  by  using  the  vessel's  position  relative 
to  the  desired  trackline.  The  bar  graph  display  gives  the  operator  another 
representation  of  his  vessel  in  the  waterway  with  respect  to  a  trackline. 

c.  The  bar  graph  software  consists  of  four  modules:  BG,  BOON, 
BLON,  and  B60FF.  BG  acts  as  the  overall  control  module  for  the  bar  graph 
software.  8G0N  displays  the  bar  graph,  i.e.,  it  outputs  a  CRT  line  of  plus 
(+)  signs  that  represent  an  analog  distance  scale.  BLON  puts  one  of  two  sets 
of  bar  graph  labels  on  the  display.  BGOFF  turns  off  the  bar  graph  and  the 
labels,  and  it  can  be  called  directly  by  the  navigation  executive. 

d.  BG  performs  the  following  sequence  of  operations.  First,  BG 
erases  the  previous  bar  graph  display  to  wipe  out  memory  of  the  previous 
inverse  video  field.  After  putting  up  a  new  bar,  it  selects  one  of  two  sets 
of  labels  based  on  the  magnitude  of  CTD  and  labels  the  bar  graph.  Then,  based 
on  the  magnitude  and  the  sign  of  CTD,  it  calculates  the  center  of  the  vessel 
image  field  within  the  bar  graph.  Using  the  vessel  center,  BG  calculates  the 
starting  and  terminating  points  for  the  inverse  video  vessel  field.  The  field 
width  is  calculated  from  the  vessel  width,  VESWID,  and  the  bar  graph  scale. 
VESWID  is  assumed  to  be  in  floating-point  yards. 

e.  BG  accepts  as  an  input  the  value  for  cross-track  distance 
(CTD).  CTD  is  assumed  to  be  in  units  of  yards  and  in  floating-point  form. 
The  output  consists  of  the  bar  graph  display.  The  bar  graph  is  represented  by 
two  lines  in  the  alphanumeric  display  memory.  The  first  line  contains  ASCII 
plus  (+)  signs  representing  calibrated  tick  marks  on  a  distance  scale.  The 
second  line  contains  the  labels  for  the  bar  graph.  The  vessel  image  is 
represented  by  an  inverse  video  field  placed  into  the  first  line.  When 
displayed  on  the  CRT  screen,  the  first  line  appears  in  row  22  and  the  second 
line  appears  in  row  23. 
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3.6.15.2  Bar  Graph  on  Module  -  360N: 


a.  8GON  is  one  of  four  modules  constituting  the  bar  graph 
display  software.  When  the  operator  has  requested  CTD  BAR  via  the  keyboard, 
the  navigation  executive  will  call  module  BG.  BG,  in  turn,  calls  BGON  to  turn 
on  the  bar  graph. 


b.  The  bar  graph  is  represented  by  one  line  of  alphanumeric 
display  memory.  The  data  contained  in  this  line  are  ASCII  plus  (+)  signs. 
The  plus  signs  represent  tick  marks  of  a  calibrated  scale.  When  displayed  on 
the  CRT  screen,  the  bar  graph  appears  as  nine  evenly  spaced  tick  marks  in  row 
22,  starting  in  column  3. 

c.  BGON  uses  the  HP  terminal's  "character-insert"  subroutine 

CHRINS. 

3.6.15.3  Bar  Labels  on  Module  -  BLON; 

a.  BLON  is  one  of  four  modules  which  constitute  the  bar  graph 
display  software.  When  the  operator  has  requested  CTD  BAR  via  the  keyboard, 
the  navigation  executive  will  call  module  BG.  BG,  in  turn,  calls  BLON  to 
label  the  bar  graph  generated  by  module  BGON.  86  is  the  only  module  that  can 
call  BLON. 


b.  As  currently  implemented,  the  bar  graph  display  can  be  one  of 
two  fixed  scales:  +100  yards  and  +500  yards.  Accordingly,  two  sets  of  labels 
are  defined.  As  described  in  Section  3.6.15.1,  the  bar  graph  consists  of  one 
line  of  alphanumeric  display  memory  containing  ASCII  plus  (+)  signs  which 
represent  tick  marks  for  a  calibrated  distance  scale.  In  both  cases  the  zero 
position  of  the  bar  graph  falls  in  the  center  of  the  SO-character  line.  The 
normal  bar  graph  labels  (+100  yards  scale)  show  tick  marks  as  25-yard 
increments  to  either  side  of  the  zero  position.  The  expanded  bar  graph  labels 
(+500  yards  scale)  show  the  tick  marks  as  125-yard  increments  to  either  side 
of  the  zero  position.  In  both  cases  the  labels  to  the  left  of  the  zero 
position  do  not  have  preceding  minus  (-)  signs. 

c.  BLON  has  two  entry  points:  BLONl  and  3L0N2.  3L0N1  is  used 

for  the  normal  scale  (+100  yards)  bar  labels  and  BLON 2  is  used  for  the 

expanded  scale  (+500  yards)  bar  labels. 

d.  Whichever  entry  point  Is  used,  3L0N  performs  the  following 

operations.  The  selected  set  of  labels  is  transferred  to  the  print  buffer, 
PRBUF.  Then  the  print  buffer  Is  written  Into  the  alphanumeric  display 

memory.  When  displayed  on  the  CRT,  the  bar  graph  labels  appear  in  row  23, 

starting  in  column  3,  and  are  lined  up  directly  below  the  tick  marks. 

3.6.15.4  8ar  Graph  Off  Module  -  3G0FF: 

a.  BGOFF  Is  one  of  four  modules  which  constitute  the  bar  graph 
display  software.  Its  function  is  to  turn  off  the  bar  graph  display.  It  can 
be  called  by  the  3G  module  or  by  the  navigation  executive.  The  navigation 
executive  will  call  BGOFF  when  the  operator  requests  that  the  bar  grapn 


display  be  turned  off.  When  the  operator  has  requested  the  bar  graph  via  the 
CTD  BAR  key  on  the  keyboard,  the  navigation  executive  will  call  the  BG 
module.  BG  also  calls  BGOFF. 

b.  When  the  CTD  8AR  is  on,  an  inverse  video  field  representing 
the  vessel  appears  in  the  bar  graph.  The  placement  and  width  of  this  inverse 
video  field  depends  on  the  vessel's  position  with  respect  to  the  trackline, 
the  vessel's  width,  and  the  bar  graph  scale.  It  is  calculated  by  the  BG 
module.  However,  the  HP  2649A  terminal  is  configured  such  that  it  "remembers" 
where  the  inverse  video  field  is.  Consequently,  it  is  necessary  to  "clear" 
the  memory  of  the  previous  inverse  video  field  before  attempting  to  create  a 
new  one.  BGOFF  performs  this  function  by  deleting  from  memory  the 
alphanumeric  line  containing  the  inverse  video  field. 

c.  BGOFF  uses  the  HP  terminal's  "clear  screen"  subroutine 
CLEARS.  The  alphanumeric  cursor  is  positioned  at  the  start  of  row  22  prior  to 
calling  CLEARS. 

3.6.16  Range  and  Bearing  -  RAB: 

a.  The  software  for  the  range  and  bearing  function  is  contained 
in  subroutine  RAB,  which  contains  four  entry  points:  IRAB,  RAB,  ERAB,  and 
IRABL. 

b.  The  range  and  bearing  function  is  activated  by  the  following 
key  sequence:  RANGE  &  BEARING  key,  move  graphics  cursor  to  desired 
destination  point,  and  EXECUTE  key.  After  this  sequence  has  been  completed, 
the  PILOT  executive  calls  IRAB  to  initialize  the  range  and  bearing  function. 
IRAB  saves  the  destination  point  coordinates,  draws  the  destination  symbol, 
writes  the  display  labels,  and  sets  the  range  and  bearing  flag  on. 

c.  While  the  range  and  bearing  flag  is  on,  the  PILOT  executive 
calls  RAB.  RAB  computes  the  range  and  bearing  from  the  vessel  to  the 
destination  point,  and  displays  the  data  on  the  screen. 

d.  The  range  and  bearing  function  is  terminated  by  the  following 
key  sequence:  CLEAR,  RANGE  and  BEARING,  and  EXECUTE.  After  this  key 
sequence,  the  PILOT  executive  calls  ERAB  to  terminate  the  range  and  bearing 
function.  ERAB  will  set  the  range  and  bearing  flag  off,  erase  the  destination 
symbol,  and  erase  the  range  and  bearing  alphanumeric  data  on  the  screen.  The 
executive  also  terminates  the  range  and  bearing  function  when  master /detail 
switching  occurs,  or  when  the  next  tape  chartlet  Is  read. 

e.  Entry  point  IRABL  is  called  by  the  executive  to  write  the 
range  and  bearing  labels  on  the  screen.  It  is  called  whenever  the  HP  terminal 
alphanumeric  display  Is  cleared  while  range  and  bearing  is  on. 

f.  Module  FRAM  defines  range  and  bearing  variables  which  are 
located  in  the  fast  RAM  area.  Fast  RAM  space  is  available  from  locations 
90E0  H  to  90FF  H. 


3.6.17 


Project  Mode: 


a.  The  project  mode  displays  a  predicted  position  of  the  vessel 
a  short  time  in  the  future.  Three  types  of  projections  are  available:  a 
linear  projection  based  on  the  vessel's  course-made-good  (CMG),  a  curved 
projection  based  on  the  vessel's  DIG  and  turning  rate,  and  a  linear  projection 
based  along  the  vessel's  heading. 

b.  The  type  of  project  Is  selected  by  changing  the  project 
variable  (PJV)  In  the  status  menu.  All  projections  are  made  for  a  fixed 
amount  of  time  in  the  future.  The  project  time  is  entered  after  activating 
the  project  mode. 


c.  The  project  mode  is  activated  by  the  following  key 
sequence:  PROJECT  key,  enter  project  time  in  minutes,  and  EXECUTE  key.  After 
this  sequence  has  been  completed,  the  PILOT  executive  will  call  subroutine 
PROJI  to  initialize  the  project  software.  PROJI  converts  the  entered  project 
time  from  ASCII  to  floating  point,  and  also  computes  the  project  Interval  time 
(PJTC)  from  the  project  time  In  seconds  divided  by  the  number  of  segments  (8) 
in  the  project  line. 

d.  If  no  project  time  Is  entered,  then  a  default  time  of  two 
minutes  is  used.  If  zero  time  Is  entered,  then  the  project  mode  is 
terminated.  The  project  flag  (PJF)  on-off  bit  is  set  on.  The  first  time 
through  bit,  which  indicates  that  a  project  line  has  been  drawn  on  the 
display.  Is  not  changed.  If  the  project  mode  is  already  on,  a  new  project 
time  can  be  entered  by  repeating  the  above  key  sequence. 

e.  The  PILOT  executive  calls  subroutine  PROJ  while  the  project 
flag  is  on  PROJ  Is  the  driver  subroutine  that  computes  the  project  line  X 
and  Y  coordinates  and  draws  the  project  line  on  the  display.  There  are 
subroutines  to  compute  the  project  line  CRT  coordinates  for  each  of  the  three 
project  types.  PROJ  checks  the  project  variable  (PJV)  and  calls  the 
subroutine  for  the  selected  project  type,  as  described  in  the  following 
sections. 


3.6.17.1  Subroutine  PROJI:  PROJI  computes  the  project  line  coordinates  for 
the  course-made-good  (CMG)  linear  project  type  (PJV*1).  The  X  and  Y  CRT 
coordinates  for  the  project  line  are  computed  as  follows: 

For  k  «  0  to  7 

X(k+1)  ■  X ( k )  ♦  VX  *  PJTC 

Y(k+1)  »  Y(k)  *  VY  *  PJTC 

where:  VX  *  X  component  of  ship's  velocity 

VY  »  Y  component  of  ship's  velocity 
PJTC  *  project  Interval  time 

The  computed  coordinates  are  saved  In  buffer  PJXY. 

3.6.17.2  Subroutine  PR0J2:  PR0J2  computes  the  project  line  coordinates  for 
the  CMG  curved  project  type  (PJV  »  2).  The  equations  for  the  X  and  Y 
coordinates  have  been  derived  so  that  they  will  yield  a  finite  result  when  the 
turning  rate  is  zero.  The  project  software  uses  the  following  equations: 
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-X('<)  «  VO  *  PJTC  [ix/2  *  cos  VO  +  sin  vol 
wY{k)  «  VO  *  PJTC  [cos  VO  -  -’r/2  *  sin  VO  J 

where: 

VO  ■  ship’s  speed 

PJTC  ■  project  interval  time 

-V  •  turning  rate  *  project  interval  time 

'r'O  ■  present  heading  angle  of  ship. 

The  terms  cos  VO  and  sin  VO  are  updated  after  every  Iteration.  The  ship's 
turning  rata  is  computed  from: 

VO  *  an /VO 

where  an  is  the  ship's  radial  acceleration  as  output  from  the  heading 
filter.  The  computed  coordinates  are  saved  in  buffer  PJXY. 

3.6.17.3  Subroutine  PROJ3:  PR0J3  computes  the  project  line  coordinates 
from  the  gyro  linear  project  type  (PJV  *  3).  This  project  type  produces  a 
linear  project  line  along  the  ship's  heading.  PR0J3  first  computes  the 
velocity  component  along  the  ship's  heading  as  follows: 

VO'  -  VO  *  cos  (~/2  -  HOG  -  CMG) 

where: 

VO  *  ship's  speed 

HOG  «  heading  angle  from  gyro 

CMG  *  ship's  course  made  good 

X  and  Y  coordinates  of  this  new  velocity  vector  are  computed,  using  the 
following  equations: 

VX'  >  VO'  *  sin  (HOG) 

VY'  «  VO*  *  COS  (HOG) 

PR0J3  then  jumps  to  subroutine  PR0J1,  which  uses  these  new  X  and  Y  velocity 
components  to  compute  the  project  line  coordinates. 

3.6.17.4  Subroutine  PRO JL :  PROJl  is  called  by  the  PROJ  driver  to  draw  the 
project  line  on  the  display.  The  project  line  contains  eight  segments,  and  a 
solid  line  is  drawn  in  complement  video  mode  between  alternate  pairs  of 
points.  The  X  and  Y  coordinates  of  the  eight  project  line  points  must  be 
saved  in  buffer  PJXY  before  calling  PROJL.  The  project  line  coordinates 
appear  in  PJXY  (32  bytes  total)  In  the  following  order: 

PJXY  »  X1MS3,  X1LSB,  Y1MSB,  YlLSB,  X2MSB,  X2LSB,  Y2MS3, 

Y2LSB,  .  X8MSB,  X8LSB,  Y8MSB,  Y8LSB. 

Each  coordinate  is  two  bytes  (single  fixed-point  format),  four  bytes  per  X  and 
Y  coordinate  pair.  The  data  In  PJXY  is  saved  until  the  next  time  PROJ  is 
called,  so  that  the  previous  project  line  can  by  erased  by  calling  PROJL 
before  new  coordinates  are  computed. 
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3.6.17.5  Subroutine  PROJX: 


a.  PROJX  is  called  to  end  the  project  mode.  PROJX  will  erase 
the  previous  project  line,  set  the  project  on-off  bit  to  off,  and  clear  the 
first  time  through  bit.  The  project  mode  is  terminated  by  the  following  key 
sequence:  CLEAR,  PROJECT,  and  EXECUTE.  The  PILOT  executive  calls  PROJX  after 
this  key  sequence  to  end  the  project  mode.  If  the  project  mode  is  already  off 
when  PROJX  is  called,  then  the  bell  rings  and  no  action  is  taken. 

b.  The  project  mode  can  be  ended  by  entering  the  above  key 

sequence,  or  by  entering  a  zero  project  time.  Project  does  not  end  on  a 

master/detail  switch  or  at  a  waypoint  file  switch.  The  first  time  thru  bit  in 
the  project  flag  (?JF)  is  cleared  on  a  master/detail  or  waypoint  file  switch 
so  that  PROJ  does  not  try  to  erase  the  old  project  line.  The  old  project  line 
is  erased  when  the  display  is  cleared  by  the  switch  software. 

3.6.18  Statistics: 

3.6.18.1  Statistical  Package: 

a.  The  PILOT  statistical  package  computes  a  mean  and  standard 

deviation  for  TDA,  T08,  TDC,  X,  and  Y  based  on  25  samples.  The  mean  and 

standard  deviation  for  each  quantity  is  printed  on  the  line  printer. 

b.  STAT  is  the  main  statistical  module.  The  entry  point  STAT 

oerforms  the  setup  required  for  the  statistical  package.  Entry  point  STATu 
updates  each  variable  based  on  a  new  raw  data  point.  The  module  UPOATE 

performs  the  updating  of  each  variable.  The  module  STATS1  calculates  the  mean 
and  standard  derivation  for  each  variable,  PRSTHD  prints  the  statistical 

header,  and  PRSTAT  prints  each  line  of  statistical  data.  These  modules  are 
described  in  greater  detail  in  the  following  sections. 

3.5.18.2  STAT  Module:  STAT  Is  the  main  module  In  the  statistical 

package.  STAT  performs  the  required  initialization,  the  updating  of  each 
variable  using  the  module  UPOATE,  computes  means  and  standard  deviation  of 
each  variable  using  STATS1,  and  prints  the  results  on  the  line  printer.  STAT 
is  called  whenever  the  statistical  flag,  SSF,  Is  set. 

3.6.18.3  UPOATE  Module:  UPOATE  performs  the  updating  of  each  variable 
according  to  the  following  equation: 

2  *  *1  *  *REF»  :2*  :z2 

3. 5. 18. A  STATS1  Module:  STATS1  computes  the  mean  and  standard  deviation  of 
each  variable,  using  the  following  equations: 

*  '  n  :z  *  xm 

s.  Jz  l2  -  iili2 

v _ H 

in 
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3.5.13.5 


PRSTHD  Module: 


PRSTHD  prints  the  statistical  header. 


3.5.18.6  PRSTAT  Module:  PRSTAT  prints  a  line  of  statistical  data.  On 

entry  RARAM  points  to  the  paramater  name;  Z  MEAN  points  to  the  mean  value;  and 

Z  STDV  points  to  the  standard  deviation.  PRSTAT  converts  the  numbers  to  ASCII 
and  prints  them. 

3.6.19  Utilities; 

3.6.19.1  Conversion  Routines; 

a.  ASCII  Floating-Point  Conversion  Routines:  Routines  ASCFP  and 

FPASC  provide  a  means  for  generating  in  RAM  the  AMO  double-precision  floating¬ 
point  numbers  from  ASCII  strings  in  RAM  (ASCFP),  and  reproducing  ASCII  strings 
from  AMO  double-precision  floating-point  numbers  (FPASC).  Routines  ASCPF  and 
FPASC  are  described  in  the  following  sections. 

b.  Routine  ASCFP;  ASCFP  will  convert  an  ASCII  string  of  up  to  8 
characters  to  an  AMlT  double-precis  ion  floating-point  number.  The  address  of 
the  ASCII  string  (least  numeric  address  and  most  significant  character)  is  in 
the  OE  register.  The  HL  register  contains  the  address  of  the  AMD  "Math  Pack" 
double-precision  floating-point  number  in  standard  PILOT  address  form  (least 
numeric  address  and  most  significant  byte  -  THE  EXPONENT).  ASCII  input 
strings  may  be  integer  or  fixed  point,  with  a  terminating  non-numeric 
character.  If  the  sign  is  omitted,  a  plus  (+)  is  assumed. 

.  c.  Routine  FPASC;  FPASC  converts  an  AMD  double-precision, 

floating-point  number  to  an  8-character  ASCII  string.  The  address  of  the 
ASCII  string  (least  numeric  address  and  most  significant  character)  is  in  the 
OE  register.  The  HL  register  contains  the  address  of  the  AMD  "Math  Pack" 
double-precision  floating-point  number  in  standard  PILOT  address  form  (least 
numeric  address  and  most  significant  byte  -  THE  EXPONENT).  The  ASCII  strings 
produced  are  left  justified. 

3.6.19.2  Routines  ASCPF  and  DFASC: 

a.  Routine  ASCPF;  ASCDF  will  convert  an  8-character  ASCII  to 
double-precision,  fixed-point  math  pack  form.  ASCDF  will  convert  only 
positive  integers  from  ASCII  to  BCD,  and  then  a  BCD  binary  routine  (3CD8IN) 
converts  the  number  to  double-precision,  fixed-point  form. 

b.  Routine  DFASC:  DFASC  performs  the  inverse  function  of  ASCDF, 
but  will  only  convert  positive  numbers  in  the  range  O^q  to  99,999, 999^g . 

3.6.19.3  Depress  to  Radians  Conversion  -  RDNDEG  and  DSGRON: 

a.  The  utility  subroutine  RDNDEG  converts  a  number  in  radians 
Into  degrees  by  multiplying  by  a  factor  of  ISO/-.  The  numbers  in  radians  are 
assumed  to  be  in  math  pack  floating-point  notation.  RDNDEG  is  located  in  the 
NUCR2  module. 


b.  Subroutine  OEGRDN  performs  the  reverse  function  of  RDNDEG  by 
converting  a  floating  point  numoer  in  degrees  into  radians  by  multiplying  by  a 
factor  of  ~/180.  OEGRON  is  located  in  the  UTIL  module. 
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2.6.19.4  Angle  Conversions  -  QEGRAQ  and  RAPDEG:  The  PILOT  unit  displays 
all  angles  using  a  navigational  reference,  where  Morth  is  0°  and  positive 
angles  are  measured  clockwise  from  North.  Angles  used  in  performing  the 
calculations  are  expressed  in  trigonometric  reference  system,  where  East  is  0° 
and  positive  angles  are  measured  counterclockwise  from  East.  The  math  chip 
used  in  performing  the  calculations  requires  angles  be  expressed  ’n  radians 
'•ather  than  navigational  degrees. 

a.  Subroutine  OEGRAO  converts  a  navigational  degree  measurement 
to  trigonometric  radians.  The  equation  used  to  perform  the  conversion  is: 
Raoians  =  “/ISO  (90-degrees).  The  number  to  be  converted  is  on  the  top  of  the 
math  pack  stack  and  the  result  is  left  on  the  top  of  the  math  pack  stack. 

b.  Subroutine  RAODEG  converts  from  trigonometric  radians  to 
navigational  degrees.  The  equation  used  to  perform  the  conversion  is: 
Degrees  3  90  -  ( 130/“  radians) .  The  number  to  be  converted  is  on  the  top  of 
the  math  pack  stack  and  the  result  is  also  on  the  top  of  the  math  pack  stack. 

3.5.19.5  Hypotenuse  Calculation  Module  -  HYPON:  The  utility  module  HYPON 
consists  of  the  subroutines  HYP0N1  and  HYP0N2  wnich  calculate  the  hypotenuse 
of  a  right  triangle. 

a.  Subroutine  HYP0N1  within  HYPON  calculates  the  hypotenuse 
according  to: 

(P3)  3  SQRT  [(Pl)**2  +  (P2)**2] 

b.  Subroutine  HYPQN2  also  within  HYPON  calculates  the  hypotenuse 
according  to: 

(?5)  3  SQRT  [(Pl-P2)**2  ♦  (P3-P4)**2] 

c.  PI,  P2,  P3,  P4,  and  P5  are  indirect  address  pointers  defined 
in  HCGM.  In  the  first  equation  above,  PI  and  P2  point  to  the  least 
significant  bytes  of  two  floating-point  numbers  representing  the  two  sides  of 
the  triangle;  ?3  points  to  the  most  significant  byte  of  where  the  floating 
point  result  is  to  be  stored.  In  the  second  equation  above,  PI,  P2,  P3,  and 
P4  point  to  the  least  significant  bytes  of  four  floating  point  numbers,  and  P5 
points  to  the  most  significant  bytes  of  where  the  floating  point  result  is  to 
oe  stored.  hyPQnI  and  HYP0N2  are  the  two  entry  points  to  HYPON. 

3.5.19.6  Arctangent  Computation  Anole  -  ARCTAN:  The  utility  module  ARCTAN 
consists  of  the  subroutines  ATmNI  and  A7AN2  wnicn  calculate  the  arctangent  of 
a  specified  argument. 

a.  Subroutine  ATANl  calculates  the  arctangent  of  the  ratio  of 
two  floating  point  numbers  according  to: 

P3  3  ARCTAN  (P1/P2) 
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b.  Subroutine  ATAN2  calculates  the  arctangent  of  the  ratio  of 
two  differences  of  floating  point  numbers  according  to:. 

P5  =  ARCTAN  [(P1-P2)/(P3-P4)] 

c.  PI,  P2,  P3,  P4,  and  P5  are  defined  in  HCOM  and  are  indirect 
address  pointers  to  the  floating  point  numbers  to  be  used.  The  resulting 
arctangent  is  a  value  between  -~/2  and  +~/2  floating  point  radians. 

3.6.19.7  Trigonometric  Function  Utility  -  TRIG: 

a.  The  utility  module  TRIG  calculates  an  elementary 
trigonometric  function  of  the  form: 

X  =  A*SIN  (ARG) 


or 


X  =  A* COS  (ARG) 

where  A  is  the  amplitude  and  ARG  is  the  argument.  Because  the  sine  and  cosine 
operations  work  with  floating  point  numbers,  TRIG  assumes  the  amplitude  and 
argument  to  be  floating  point  numbers. 

b.  TRIG  uses  indirect  addressing  to  obtain  its  input  and  output 
parameters.  It  executes  the  following  equation: 

P3  =  P1*(TRIG  FCN  (P2)) 

where  TRIG  FCN  is  the  sine  or  cosine  command  in  the  accumulator.  PI  contains 
the  address  of  the  least  significant  byte  of  the  amplitude  number,  and  P2 
contains  the  address  of  the  least  significant  byte  of  the  argument  or  angle 
number.  P3  contains  the  address  of  where  the  most  significant  byte  of  the 
floating  point  result  is  to  be  stored.  PI,  P2,  ? 3,  and  the  accumulator  are 
set  up  prior  to  entry  into  TRIG. 

3.6.19.3  Escape  Sequence  Interrupter  -  ESC I:  The  escape  sequence  command 
structure  provides  the  operator  with  a  powerful  means  of  controlling  the 
Hewlett-Packard  terminal.  Escape  sequences  are  'written  and  executed  under 
complete  software  control.  Routine  ESC  I  provides  the  software  necessary  for 
executing  an  escape  sequence  which  has  been  written  by  any  software  module. 
The  only  requirements  are  that  a  string  be  in  ASCII,  start  with  an  escape 
character  (13  H),  and  end  with  a  null  character  (00  H).  To  call  ESCI,  place 
address  of  the  string  in  the  H  and  L  registers. 

3.6.19.9  Data  Transfer  -  XFER:  Utility  program  XFER  transfers  data  from 
one  area  of  memory  to  another.  The  source  address  of  the  data  Is  specified  in 
the  DE  register  pair  and  the  destination  address  of  the  data  is  specified  in 
the  Hi  register  pair.  The  number  of  bytes  to  be  moved  is  specified  in  the  3 
'•egister.  On  exit,  3  is  zero  and  HI  and  DE  are  incremented  by  N. 

3.6.19.10  Square  of  a  Number  -  SQRX  or  FXSQRX:  Utility  SQRX  calculates  a 
square  of  a  number  whicn  is  on  top  of  the  math  pack  stack.  SQRX  calculates 
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tne  square  of  a  floating  point  number.  Utility  FXSQRX  calculates  the  space  of 
a  fixeo-point  numoer.  In  each  case  the  result  remains  on  top  of  the  stack. 

3.6.19.11  CRT  to  Real  World  Coordinate  Transformation  -  CRTRW: 

a.  Utility  CRTRW  transforms  coordinates  between  the  CRT 
coordinate  system  and  a  real-world  (loran  chain)  coordinate  system. 

b.  The  inputs  to  CRTRW  are  the  CRT  coordinates  of  some  point  on 
the  screen.  These  coordinates  are  given  as  16-bit,  2's  complement  binary 
integers  stored  at  locations  CRTX,  CRTX+1  and  CRTY,  CRTY+1.  Other  inputs  are 
the  display  origin  coordinates,  the  display  rotation  angle,  and  the  CRT  scale 
factor.  These  inputs  are  stored  as  floating  point  numbers. 

c.  The  outputs  of  CRTRW  are  real-world  X  and  Y  coordinates  of 
the  point  in  question.  The  real-world  coordinates  are  32-bit  floating  point 
numbers.  The  X  coordinate  is  stored  at  the  floating  point  variable  XRW  and 
the  Y  coordinate  is  stored  at  the  floating  point  variable  YRW. 

d.  Figure  3-29  illustrates  the  two  coordinate  systems  and  the 
transformation  equations  involved. 

3.6.19.12  Real  World  to  CRT  Coordinate  Transformation  -  RWCRT: 

a.  Utility  RWCRT  transforms  coordinates  between  a  real-world 
(loran  chain)  coordinate  system  and  the  CRT  coordinate  system. 

b.  The.  Inputs  to  RWCRT  are  the  coordinates  of  seme  point  in  the 
real-world  coorainats  system,  the  coordinates  of  the  display  origin,  the 
display  rotation  angle,  and  the  CRT  scale  factor.  These  quantities  are  stored 
as  floating  point  numbers. 

c.  The  outputs  of  RWCRT  are  the  CRT  X  and  Y  coordinates  of  the 

point  in  question.  The  CRT  coordinates  are  16-bit,  2's  complement  binary 
integers.  The  X  coordinate  is  stored  at  CRTX  and  CRTX+1,  while  the  Y 

coordinate  is  stored  at  CRH  and  CRTY+1. 

d.  Figure  3-30  illustrates  the  two  coordinate  systems  and  the 
transformation  equations  involved. 

3.6.20  Error  Handling  Routines: 

a.  When  an  .error  condition  occurs  in  the  navigation  loop,  the 
navigation  process  is  halted.  Rather  than  halt  the  PILOT,  a  group  of  routines 
exist  to  handle  all  possible  error  conditions.  The  basic  philosophy  is  to 
display  an  error  message,  reset  the  stack  pointer,  and  continue  execution  at 
EXLOOP.  The  error  message  informs  the  operator  of  the  cause  of  the  problem. 
The  stack  pointer  must  be  reset  so  that  the  stack  does  not  overflow  due  to  a 
continuous  error  condition.  EXLOOP  is  the  beginning  of  the  navigation  loop. 
3y  continuing  at  EXLOOP,  PILOT  will  usually  recover  from  the  error  condition. 

b.  An  error  display  field  has  been  established  on  a  normal  PILOT 
navigation  display  below  the  alphanumeric  field.  ERC  is  called  at  the  end  of 
the  navigation  loop  to  clear  the  error  display  field. 
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IV  •  [FLT(CRTX)»COS(©>  -  FLT  (CRTY)«SIN(©)j  /SCL  -  X0 

V  -  (FLT(CRTX)*SIN(©I  -  FLT  (CRTY|-CQS(QU  SCL  *  Y0 

,  WHERE: 

SCL  -  SCALE  FACTOR.  CRT  LINES/YARD 
f\  REAL  WOriLO  (LORAN  CHAIN)  COORDINATE  SYSTEM 
Y':  DISPLAY  COORDINATE  SYSTEM 


FIGURE  3-29  CRTRW  COORDINATE  SYSTEMS 


X 


CRTX  -  FIXS  t(x-x0)»COS (0)  -  (yy0)«SIN(©>]  *SCL 

CRTY  -  FIXS  [(y-y0)*COS<e>  *  (x-x0)*SIN(6)J  »SCL 
,  WHERE: 

SCL  ■  SCALE  FACTOR,  CRT  LINES/YARD 
X,  Y:  REAL  WORLD  (LORAN  CHAIN)  COORDINATE  SYSTEM 
X',  Y1:  DISPLAY  COORDINATE  SYSTEM 

FIGURE  3-30  RWCRT  COORDINATE  SYSTEMS. 
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3.5.20.1  Routine  TER:  Tape  read  errors  are  handled  by  TER.  When  TER  is 
called,  the  message  “TAPE  READ  ERROR'  is  displayed,  the  stack  pointer  is 
reset,  and  execution  continues  at  EXLOOP.  By  continuing  execution  at  EXLOOP 
the  PILOT  will  attempt  to  recover  from  a  read  error,  rather  than  halting  in 
error  loop. 


3.5.20.2  Routine  TOER;  When  TO  to  XY  conversion  routines  fail  to  converge, 
TDER  is  called.  TOER  displays  the  message  'FAIL  TO  CONVERT',  resets  the  stack 
pointer,  and  continues  execution  at  EXLOOP. 

3.5.20.3  Routine  TOPER:  Where  two  or  more  TD's  are  invalid,  according  to 
the  edit  process,  TDDER  is  called.  TDDER  turns  on  the  correct  inverse  video 
fields,  displays  the  message  'NAVIGATION  HALT',  resets  the  stack  pointers,  and 
continues  execution  at  EXLOOP.  The  TD  status  is  in  the  accumulator  when  TDOER 
is  called. 

3.6.20.4  Routine  TOAER:  When  the  TD  bias  contains  invalid  entries,  TDAER 
/is  called.  TDAEr  displays  the  message  'BAD  TD  BIAS  DATA',  resets  the  stack 
pointer,  and  continues  execution  at  EXLOOP. 

3.5.20.5  Routine  MPER:  When  the  math  pack  status  indicates  an  error  has 
occurred,  MPER  is  called.  MPER  extracts  the  return  address  of  the  routine 
which  called  MAP,  displays  the  message  ‘MATH  ERROR  RA=‘  along  with  the  return 
address,  resets  the  stack  pointer,  and  continues  execution  at  EXLOOP.  MPER 
uses  HEXASC  to  convert  the  return  address  to  ASCII  for  display. 

3.6.20.5  Routine  3ER:  During  conversion  from  BCD  to  binary,  if  any  invalid 
data  are  encountered,  BER  is  called.  3ER  retrieves  the  return  address  of  the 
routine  which  called  BCDBIN,  displays  the  message  '3AD  BCD  DATA  RA*'  along 
with  the  return  address,  resets  the  stack  pointer,  and  continues  execution  at 
EXLOOP.  8ER  uses  HEXASC  to  convert  the  return  address  to  ASCII  for  display. 

3.6.20.7  Routine  ERC:  The  error  display  field  is  cleared  when  ERC  is 
called.  A  call  to  ERC  occurs  at  the  end  of  the  navigation  loop  in  order  to 
clear  the  error  display  field. 

3.6.20.8  Routine  HEXASC:  HEXASC  performs  conversion  of  hexadecimal  to 
ASCII.  On  entry  0£  points  to  the  destination  of  the  ASCII,  and  HL  points  to 
the  byte  to  be  converted. 

3.6.21  Hewlett-Packard  Software  Referenced  by  PILOT  -  HPSO:  Routine  HPSO 
defines  the  entry  vectors  and  variaoles  contained  in  the  Hewlett-Packard  code 
which  the  PILOT  code  uses.  No  calls  are  made  to  HPSD;  only  the  quantities 
defined  herein  are  used  to  satisfy  external  references  in  PILOT. 

3.6.22  Diagnostic  Data:  When  the  PILOT  unit  is  placed  in  the  diagnostic 
mode  the  only  raw  data  needed  are  contained  in  subroutines  DIAO  or  DIAD1. 
DIAD  contains  the  TD's  in  math  pack  and  raw  data  forms  required  to  place  the 
vessel  at  the  waypoint.  No  calls  are  made  to  DIAD.  DIAO  is  used  only  to 
ootain  TD's  for  the  diagnostic  mode.  DIAD1  contains  the  TD's  in  math  pack  and 
raw  data  forms  to  place  the  vessel  at  a  point  300  feet  f’-om  the  waypoint.  No 
calls  are  made  to  0IAD1.  DIADi  is  used  only  to  obtain  TD's  for  the  diagnostic 
mode. 


3-68 


4.0 


8085  SOFTWARE  RECEIVER  INTERFACE. 


4.1  Receiver  Interface  Software  Package: 

a.  The  functions  of  the  receiver  interface  card  are  to  read  TO's 
(from  at  most  two  Loran-C  receivers,  select  the  TO's  for  navigation,  filter  the 
navigation  TO's,  and  provide  the  Hewlett-Packard  8080  microprocessor  with  the 
current  navigation  TO's  on  request.  The  receiver  interface  software  has  been 
modularized  using  structured  programing  techniques.  This  procedure  has 
enabled  the  receiver  interface  software  to  interface  any  two  Loran-C  receivers 
to  PILOT  by  including  in  the  receiver  interface  software  package  the 
appropriate  modules  whose  function  is  to  handle  the  raw  data  from  the 
corresponding  Loran-C  receiver. 

b.  The  PILOT  program  is  interfaced  to  a  Teledyne  708  and 
Internav  Mark  III  Loran-C  receiver  combination  and  to  a  Teledyne  708  and 
Internav  LC404  Loran-C  receiver  combination.  Two  distinct  hardware  and 
software  packages  are  utilized  in  these  interfaces.  The  memory  maps  are 
basically  the  same  for  both  designs  (see  Fig.  4-1).  The  only  minor  difference 
is  that  a  USART  was  added  at  3600  H  to  communicate  with  the  Internav  LC404. 

c.  The  software  package  which  handles  the  interface  to  the 
Teledyne  703  and  Internav  Mark  III  Loran-C  receiver  combination  is  controlled 
by  an  executive  program,  REXEC  original.  This  version  of  REXEC  performs  all 
the  control  and  decision  processes  required  in  interfacing  PILOT  to  this 
receiver  combination.  Associated  with  this  version  of  REXEC  is  RICGM  Ver¬ 
sion  4,  which  defines  all  variables  used  in  the  receiver  interface  software. 

d.  When  another  receiver,  the  Internav  LC404,  was  interfaced  to 
PILOT  with  the  Teledyne  708,  the  software  package  for  the  LC4Q4  replaced  the 
Internav  Mark  III  software  package  in  the  existing  receiver  interface  soft¬ 
ware.  Also,-  certain  modules  had  to  be  modified  to  accommodate  this  re¬ 
ceiver.  REXEC,  RICOM,  and  TI  were  modified  to  Revison  A  level  to  accommodate 
this  receiver. 


e.  When  the  8080  microprocessor  wants  the  current  navigation 
TO's,  the  receiver  interface  software  services  an  interrupt  which  handles  this 
communication.  Communication  between  the  8080  and  8C35  microprocessors  is  via 
I/O  ports  rather  than  memory  locations  as  viewed  from  the  3035  microprocessor . 

f.  The  Teledyne  708  and  Internav  Mark  III  receivers  output  their 
TO's  at  a  regular  rata.  The  Internav  LC404  receiver  will  output  TO's  only  on 
request.  This  request  for  data  from  the  receiver  interface  occurs  every  0.5 
second.  The  feature  has  been  added  to  the  REXEC  wait- loop. 

4.2  Interrupts : 

4.2.1  Internav  Mark  III  Receiver  Software:  The  software  module  IRI 
communicates  with  the  Internav  Mark  III  receiver.  IRI  is  called  when  an  RST 
6.5  Interrupt  occurs.  IRI  makes  the  determination  if  any  TO  data  are  on  the 
data  lines  and  If  the  receiver  Interface  is  in  the  initialization  or  filtering 
moae  and  then  places  the  data  in  the  appropriate  data  buffer.  While  servicing 
this  interrupt  all  other  Interrupts  are  disabled. 


I 


4.2.2 


Internav  LC404  Receiver  Software  Package: 


a.  The  software  to  process  data  from  the  Internav  LC404  receiver 
was  written  to  me&h  <with  the  existing  software  in  the  receiver  interface 
card.  The  LC404QsJfVware  package  takes  the  place  of  the  Internav  Mark  III 
software  packagO 

b.  The  LC404  software  package  consists  of  nine  subroutines,  each 
of  which  perform  a  part  of  the  total  interface  to  the  IC4Q4.  Descriptions  of 
these  subroutines  are  in  the  following  sections. 

4. 2. 2.1  Subroutine  FQFSU:  FQFSU  initializes  the  USART  which  communicates 
with  tne  Internav  LC404  receiver.  The  proper  command  bytes  are  sent  to  the 
USART  to  configure  it  for  communications  with  a  USART  in  the  LC404  receiver. 


4 . 2 . 2 . 2  Subroutine  FDR: 

Internav  LC404  receiver, 
operations . 


FDR  initiates 
See  Fig.  4-2 


request  for  TO  data  from  the 


chart 


detailed 


4. 2. 2. 3  Subroutine  DELAYT ;  DELAYT  generates  a  wait  state  in  the  processor 
by  executing  a  loop  N  times.  Where  N  is  specified  in  the  DE  register  pair,  N 
times  the  amount  of  time  required  to  execute  the  loop  yields  the  total  delay 
time.  The  amount  of  time  required  to  execute  the  loop  is  a  function  of  the 
system  clock,  which  is  10  microseconds  in  DELAYT. 

4. 2. 2. 4  Subroutine  FQFI:  FQFI  is  the  interrupt  handler  for  the  Internav 
LC404  receiver  whicn  is  an  RST  6.5.  FOFI  saves  the  registers,  reads  the  USART 
states,  and  determines  if  the  USART  Is  transmitting  or  receiving.  If  USART  is 
transmitting,  FOFI  jumps  to  FQFT.  If  the  USART  is  receiving,  FOFI  jumps  to 
FOFR. 


4. 2. 2. 5  Subroutine  FQFT:  FOFT  completes  the  data  request  and,  upon 
completion  of  the  request  message,  reconfigures  the  USART  to  receive  data. 
The  basic  function  of  FOFT  is  to  transmit  another  byte  to  the  Internav  LC404 
receiver.  Before  transmitting  a  check  Is  made  to  determine  if  more  data  are 
to  be  transmitted.  If  no  data  are  to  be  transmitted  the  USART  is  set  to 
receive  cnaractars  from  the  LC404  receiver. 

4. 2. 2. 6  Subroutine  FOFR:  FOFR  receives  characters  from  the  Internav  IC4CA 
receiver.  It  also  determines  when  all  characters  have  been  received  from  the 
receiver,  sets  the  receiver  status  byte  to  indicate  this  event,  stores  the 
data  from  the  receiver,  and  denotes  the  completion  of  the  data  from  the  LC404 
receiver . 

4.2.2. 7  Subroutine  FOFUP:  FOFUP  unpacks  the  raw  IC4Q4  receiver  data  on  a 
TD  basis  and  places  the  TD  in  memory.  The  calling  routine  points  to  the  TD  in 
the  HL  register  pair  and  specifies  where  to  put  the  data  in  the  OE  register 
pair. 

4. 2. 2. 3  Subroutine  F0FI0;  FOFID  uses  FOFUP  to  format  the  LC404  data  for 
the  identification  process  and  checks  the  status  byte  from  the  Internav  LC4Q4 
receiver  to  determine  if  the  TO's  are  valid  according  to  the  LC404.  If  the 
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FIG.  4-2  FOR  FLOW  CHART 


TD's  are  noc  valid,  subroutine  FOR  is  used  to  request  TD's  again.  If  the  TO's 
are  valid,  subroutine  FOFUP  is  used  to  put  the  TD's  in  the  format  required  to 
identify  the  TO's  using  IOENT. 

4. 2. 2. 9  Subroutine  FOFO:  FOFO  uses  FOFUP  to  format  the  data  for  use  by 
the  filters  if  any  TO's  from  the  LC404  receiver  are  being  used  for 
navigation.  If  any  of  the  TD's  are  being  used,  they  are  unpacked  via  FOFUP 
and  placed  in  memory  as  required  by  the  filter  routines. 

4.2.3  Teledyne  Receiver  Software  TRI:  The  TRI  software  module  handles 
the  Teledyne  receiver  raw  data.  When  an  RST  5.5  interrupt  occurs,  TRI  is 
called.  TRI  determines  if  the  receiver  interface  is  in  the  initi al ization  or 
filtering  mode  and  reads  the  raw  data  into  the  appropriate  buffer.  When  this 
interrupt  is  being  serviced,  all  other  interrupts  are  disabled. 

4.2.4  Timer  Interrupt  in  the  Receiver  Interface: 

a.  The  timer  interrupt  in  the  receiver  interface  serves  as  a 
real-time  clock  with  100-millisecond  tick  marks.  This  100-millisecond 
interval  has  been  determined  as  the  rate  at  which  the  TO  filters  will  be  dead 
reckoned  (DR).  If  raw  data  are  available  the  raw  data  will  be  incorporated 
into  the  filter  after  the  DR  process. 

b.  While  updating  the  filters  the  receiver,  interface  interrupts 
will  be  active  to  avoid  losing  any  data  from  the  receivers.  The  subroutines 
associated  with  the  timer  interrupt  are  described  in  the  following  sections. 

4. 2. 4.1  Subroutine  TIR:  TIR  services  the  timer  interface  interrupt  which 
is  the  TRAP  interrupt.  Every  100  milliseconds  the  hardware  clock  issues  an 
interrupt  which  is  serviced  by  TIR.  TIR  sets  a  flag,  ATI,  which  is  examined 
by  the  wait-loop  to  determine  if  a  timer  interrupt  has  occurred  and  reenables 
the  interrupts. 

4. 2. 4. 2  Subroutine  TI: 

a.  TI  maintains  three  independent  time  counters,  which  are  used 
as  binary  clocks  by  the  filter  update  routines,  and  updates  the  TD  filters. 
TI  examines  each  of  three  possible  TD  running  filters  to  determine  if  they  are 
running.  Any  active  filter  is  updated  using  subroutine  TDQR.  After  examining 
all  TD's  the  buffer  pointer  is  updated  to  point  to  the  current  buffer.  TI 
then  uses  EXLOOP  to  incorporate  any  available  raw  data  into  the  TD  filers. 

b.  Revision  A  of  TI  performs  the  same  functions  as  TI.  An  extra 
counter,  OPC,  has  been  added  to  detect  when  0.5  second  intervals  for 
interrogating  the  Internav  LC404  receiver  occur. 

4. 2. 4. 3  Subroutine  TDQR; 

a.  TOOR  performs  only  the  OR  process.  If  raw  data  are  available 
EXLOOP  incorporates  it  into  the  TD  filters.  Associated  with  each  TD  is  a  TD 
and  a  TO.  When  the  TD  is  updated,  TD  is  also  updated. 


b.  TQOR  performs  the  following  calculations: 

TO^  *  TO^  +  ct  TO^  +  a  t ^  TD 

2 

TD^  *  fb^  +  At  TD 


To  accommodate  all  modes  of  operation  of  these  equations  it  is  necessary  to 
maintain  a  double-precision  floating-point  part  and  a  double-precision 
fixed-point  part  of  each  TD. 

4. 2. 4. 4  Subroutine  FILTER:  FILTER  incorporates  a  new  TD  value  into  the 
current  TO  filter  value.  FILTER  executes  the  following  equations: 

TD  =  T0i  +  *  8  *  0TA^  (tDm  +  DTa*  T0i  +  DTA2  *  TD  -  TD.^ 

TD  *  T0i  ♦  L  (TDM  +  DTa  *  TD^  DT  A2  TD  -  TD  . 

2 

4.2.5  Hewlett-Packard  Interrupt  Handling  In  the  8085: 

a.  The  Hewlett-Packard  terminal  can  interruDt  the  8085  using  the 
RST  7.5  of  the  8085.  When  this  occurs,  the  8085  jumps  to  HPIH,  Hewlett- 
Packard  interrupt  handler.  HPIH  reads  the  comnand  byte  which  is  in  Port  A  and 
the  status  in  Port  C.  The  command  byte  is  decoded  to  determine  what  data 
exchange  is  to  follow  and  calls  one  of  the  following  routines:  TDIO,  TDIDEN, 
TOFC.  MEMO,  01 AG  or  0IAG1. 

b.  Each  routine  handles  a  different  data  exchange  between  the 
8080  and  8085  in  the  8085.  Descriptions  of  the  functions  of  these  routines 
are  contained  in  the  following  sections: 

4.2.5. 1  Routine  T0I0:  TDIO  is  called  by  HPIH  to  exchange  status,  TD's, 
TD's,  and  TD's  between,  the  8080  and  8085.  It  uses  STACW  and  STACR  to  deter¬ 
mine  when  data  are  to  be  read  from  or  placed  in  the  appropriate  ports.  Data 
are  sent  in  the  following  order  to  the  8080:  status,  TD's,  TD's,  The  TD's  are 
then  sent  from  the  8080. 

4. 2. 5. 2  Routine  TDIDEN:  TDIDEN  Is  called  by  HP  ID  to  receive  identifying 
TD's  from  the  8080.  It  uses  STACR  to  determine  when  the  8080  has  placed  dat.; 
in  Port  8  to  be  read.  Three  sets  of  TD's  are  sent  from  the  3080  and  are  to  be 
usea  to  select  the  desirable  navigation  TD's  from  the  receivers. 

4. 2. 5. 3  Routine  TOFC:  TOFC  is  called  by  HPIH  to  receive  filter  constants 
from  the  3080,  and  it  uses  STACR  to  determine  when  the  8080  has  placed  data  in 
Port  3  to  be  read.  Six  sets  of  filter  constants  are  sent  from  the  3080,  and 


•  i 
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after  placing  these  constants  in  RAM  a  check  is  made  to  determine  if  this  is 
the  initial  start  up.  If  initial  start  up  is  determined,  a  flag  is  cleared  to 
indicate  the  filter  constants  have  been  received.  If  there  is  no  initial 
start,  the  TO  filters  are  reinitialized  using  the  current  TD's  from  the 
receivers. 


B 


A. 2. 5. 4  Routine  MEMO:  MEMO  is  called  by  HP  ID  to  send  the  entire  8085  RAM 
from  2040  H  to  20 FF  H  to  the  8080.  This  is  used  only  for  checkout  purposes; 
this  routine  is  never  used  during  normal  operation. 


4. 2. 5. 5  Routine  DIAG:  DIAG  is  called  by  HPIH  to  place  the  3085  in  a 

di agnostic  modi"!  In  the  diagnostic  mode,  the  receiver  interrupts  are  dis¬ 
abled,  and  TD's  are  placed  in  the  input  buffer  as  though  the  receiver  had  sent 

4  them.  The  8085  then  operates  as  usual,  assuming  the  TD's  were  from  the 
*  receivers.  The  TD's  place  the  vessel  at  the  waypoint. 

4. 2. 5. 6  Routine  QIAG1:  OIAGI  performs  the  same  as  DIAG,  except  that  the 

TD's  place  the  vessel  at  a  point  300  feet  from  the  waypoint. 

f  4. 2. 5. 7  STACW  -  Check  Status  Port  B:  STACW  checks  the  status  port, 

address  23  H  of  the  8085,  to  determine  when  Port  B  data  have  been  read  by  the 
3080.  When  STACW  is  called  in  normal  use,  it  continually  checks  the  status 
until  bit  4  is  set.  Control  returns  to  the  calling  rout..-:  when  this 
occurs.  If  this  bit  is  not  set  within  65,000  checks,  i.e.,  FFFF  H,  then 
control  passes  to  the  error  routine,  EREX.  No  parameters  are  passed. 

t 

4. 2. 5. 8  STACR  -  Checks  Status  Port  A:  STACR  checks  the  status  port, 

address  23  H  of  the  8035,  to  determine  when  Port  A  has  been  loaded  with  data 
by  the  8080.  When  STACR  is  called  in  normal  use,  it  continually  checks  the 
status  port  until  the  two  least  significant  bits  are  set.  Control  returns  to 
the  calling  routine  when  this  occurs.  If  these  bits  are  not  set  within  65,OOC 
2  checks,  I.e.,  FFFF  H,  then  control  passes  to  the  error  routine,  EREX.  No 

parameters  are  passed. 

4.3  EXECUTIVE. 

REXEC  consists  of  two  main  sections,  the  receiver  interface 

•  control  and  TD  filter  update  software.  The  control  section  performs  the  setup 

and  Initialization  required  to  place  the  processor  in  the  TD  filtering  mode. 
After  having  performed  these  functions  REXEC  is  permanently  in  an  inactive 
wait-loop.  At  this  time  the  filtering  process  is  interrupt  driven.  When 
receivers  have  data  available,  the  data  are  read  into  raw  data  buffers.  At  a 
0.1  second  interval,  the  TD  filters  are  dead-reckoned  (DR)  to  a  new  value. 

•  The  TO  filter  update  section  then  decides  if  the  raw  data  buffers  contain  new 

data.  If  they  contain  new  data,  then  each  TD  filter  Is  updated  by  a  new  value 

using  the  routine  FILTER. 

4.3.1  Routine  REXEC:  REXEC  Is  the  executive  routine  for  the  receiver 

;  interface  software  package.  REXEC  is  not  called  by  any  routine  and  performs 

•  all  the  control  and  decisions  in  the  receiver  interface.  REXEC  interfaces  the 
Teledyne  708  and  Internav  Mark  III  receiver  to  PILOT.  Another  version  of 
REXEC  performs  identically,  except  that  this  software  '"nterfaces  a  Teledyne 
708  and  Internav  LC404  receiver  to  PILOT. 
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4.3.2  Routine  RICQM:  RICQM  defines  all  variables  used  in  the  receiver 
interface  software.  The  original  version  of  RICOM  is  used  with  the  original 
version  of  REXEC.  No  calls  are  made  to  RICOM,  only  the  variables  defined 
herein  are  used.  Revision  A  of  RICOM  is  used  with  revision  A  of  REXEC. 

4.3.3  TO  Identification  Process:  Before  the  PILOT  unit  can  begin 

navigation,  tne  receiver  interface  software  must  determine  the  origin  of  the 
TO's.  The  receiver  interface  could  be  connected  to  two  receivers,  each  of 
which  outputs  four  TO's  for  a  total  of  eight  TD's.  Routines  IDENT  and  TDIM 
perform  the  functions  on  the  TD's  which  are  described  in  the  following 
sections . 

4. 3. 3.1  Routine  IDENT :  The  TO  identification  process  is  performed  by 
ICENT.  3y  using  the  value  of  a  maximum  of  three  TO's,  IDENT  determines  if  any 
of  the  TO's  from  the  receivers  are  within  1000  microseconds  of  any  of  these 
three  TO's.  When  a  TO  from  a  receiver  is  identified,  an  identification  byte 
is  set  to  signify  that  the  TO  will  be  used  for  navigation.  The  receiver  time 
delay  is  also  set  according  to  the  source  of  the  TO.  When  all  TO's  from  both 
receivers  are  examined,  the  receiver  interface  software  is  then  ready  to 
enaole  the  filters.  IDENT  uses  TDIM  to  perform  the  mathematical  operations 
involved  in  the  TO  identification  process. 

4. 3. 3. 2  Routine  TOIM:  The  mathematical  operations  involved  in  the  TD 
identification  process  are  performed  by  TDIM.  TDIM  performs  the  following 
calculation: 


1  millisecond  -  [  TDX  -  TOI  { 

where  TOX  is  some  unknown  TO  and  TOI  is  a  known  TD.  If  the  result  of  the 
calculation  is  positive,  the  TOX  is  assumed  to  be  TDI.  The  address  of  TOI  is 
in  the  CE  register  pair  and  the  address  of  TDX  is  in  the  HL  register  pair  when 
TOIM  is  called.  On  exit  the  accumulator  contains  the  math  pack  status  which 
contains  the  sign  of  the  result  of  the  calculation. 

4.3.4  Memory  Initialization  in  the  Receiver  Interface  -  MEMI:  MEM I 
initializes  tne  RAM  area  of  the  receiver  interface  from  the  initial  turn  on 
configuration  to  the  filter  mode.  When  the  receiver  interface  is  powered  on, 
the  RAM  area  is  configured  to  identify  which  TD’s  from  which  receiver  will  be 
used.  The  stack  is  cleaned  up  by  resetting  the  stack  pointer,  and  the  TD 
buffer  and  alternate  TO  buffer  scheme  are  established. 

When  this  process  is  completed  the  filters  are  then  enabled. 
Prior  to  enabling  the  filters,  MEMI  reconfigures  RAM  for  the  filter  process. 
The  status  flags  are  set  and  cleared  as  required  by  data  logging. 

4.3.5  CHATO  -  Change  In  TD  Module: 

a.  Routine  CHATO  computes  the  change  in  TO  from  the  previous 
update  to  the  present  update  and  compares  this  change  to  a  "window"  value.  If 
the  change  in  TD  falls  within  this  window,  then  the  new  TO  is  considered 
"good";  otherwise,  It  is  considered  "bad"  and  is  rejected.  CHATO  is  called  by 
tne  receiver  interface  executive  following  inout  of  a  TO  from  the  receiver. 


The  executive  first  calls  8CD8IN  to  convert  the  raw  TD  to  its  32-bit  binary 
integer  equivalent  and  then  calls  CHATD  to  compare  the  present  TD  value  with 
the  previous  one. 


b.  The  CHATD  routine  operates  in  the  following  manner.  Based  on 
maximum  allowable  vessel  dynamics  and  the  rates-of-change  of  the  TD's,  a  TD 
"window”  value  is  specified.  This  window  defines  the  maximum  expected  change 
in  TD  if  the  vessel  is  undergoing  the  maximum  dynamics  (e.g.,  a  full-speed, 
hard-turn  situation).  CHATO  subtracts  the  previous  TD,  which  has  been  saved 
from  the  present  TO  to  produce  a  change-in-TD  value. 

c.  The  absolute  value  of  the  change-in-TC  value  is  then  compared 
to  this  "window"  specification.  If  the  change-in-TD  value  falls  within  the 
window,  the  TD  is  "good".  Otherwise,  it  is  considered  "bad"  and  is  not  used 
in  the  TD  transf crmation  algorithm.  Symbolically,  if  W  represents  the  window 
which  is  nanoseconds,  then  CHATD  performs  the  following  operation: 

i  TD.NEW  -  TO. OLD  |  <  W? 

where  the  question  mark  (?)  signifies  the  comparison  results.  The  window 
width,  W,  is  currently  set  at  3C00  nanoseconds. 

d.  The  receiver  interface  software  sets  up  the  TD  status  word, 
which  is  then  sent  to  the  Intel  8080  mainframe  Central  Processing  Unit  (CPU) 
and  identifies  the  "good"  and  "bad"  TO's. 

4.3.6  Error  Handler  in  the  8085  -  EREX:  EREX  is  the  error  handling 
routine  for  the  8085  microprocessor  and  is  called  when  an  error  occurs  in  the 
receiver  interface  software.  This  routine  turns  off  all  interrupts  except  the 
3080  interrupt  and  sets  a  status  byte  to  indicate  the  problem.  The  receiver 
interface  will  remain  in  EREX  until  the  processor  is  reset.  The  software  has 
assumed  that  when  EREX  is  called,  a  fatal  error  has  occurred  and  the  only  way 
to  recover  is  with  a  hard  reset. 

4.3.7  BCO-to-Binary  Conversion  Module  -  BCOBIN : 

a.  BCOBIN  converts  a  seven-digit  number  to  its  equivalent  32-bit 
binary  integer  value.  It  is  called  by  the  receiver  interface  executive  each 
time  a  time  difference  must  be  converted. 

b.  BCD8IN  converts  the  seven-digit  BCD  number  to  binary  form. 
BCOBIN  uses  a  direct  conversion  algorithm,  i.e.,  the  least  significant  byte 
(the  status  byte)  is  multiplied  by  zero  and  added  to  an  accumulator.  The  next 
byte  is  multiplied  by  10  and  summed.  The  third  byte  is  multiplied  by  100  and 
summed.  This  process  continues  until  the  most  significant  byte  is  multiplied 

by  10^  and  summed  into  the  32-bit  binary  accumulator.  The  final  sum  of  the 
products  represents  the  32-bit  binary  integer  equivalent  of  the  seven-digit 
BCD  input  number.  The  32-bit  binary  integer  is  retrieved  from  the  math  pac< 
and  stored  in  RAM  memory. 
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c.  The  powers  of  10  are  coded  as  a  fixed  table.  Each  power  of 
10  is  represented  by  a  32-bit  binary  integer  (four  bytes).  The  greatest  power 

of  10  is  107,  and  the  least  power  of  10  is  10^.  The  powers  of  10  table  has 
the  name  FACTOR.  FACTOR  addresses  the  most  significant  byte  of  the  most 

significant  power  of  10  (*107). 

d.  3CDBIN  also  performs  a  validity  check  on  each  of  the  BCD 
digits  it  sends  to  t:.e  math  pack,  i.e.,  the  BCD  digits  must  fall  in  the  numer¬ 
ical  range  of  zero  to  nine.  If  a  digit  is  outside  of  this  range,  an  error 
condition  exists,  and  BCDBIN  jumps  to  an  error  processing  module,  EREX. 
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MATH  HANDLERS. 


5.1  8asic  Math  Pack  Handler  Routines:  The  AMD  9511  math  chip  requires 
that  it  receives  data  along  with  a  command,  and  that  after  the  command  is 
executed,  the  result  is  retrieved  from  the  math  chip.  The  functions  performed 
by  the  processors  require  numerous  math  operations.  To  simplify  software 
coding,  three  software  modules  —  LDMP,  MPRDY,  and  STMP  —  have  been  written 
which  communicate  with  the  math  chip.  These  modules  are  discussed  in  Sections 

5.1.1  through  5.1.4. 

5.1.1  Routine  L0MP1:  LDMP1  transfers  one  4-byte  operand  and  a  command 
to  the  AMD  9511  math  chip. 

Entry  Conditions: 

HL  contains  address  of  LS8  of  operand  3. 

C  contains  command  to  be  executed. 

Exit  Conditions: 

HL  contains  MSB  address  of  operand  B. 

A  &  C  contain  command. 

5.1.2  Routine  LDMP2:  LDMP2  transfers  two  4-byte  operands  and  a  command 
to  the  AMD  9511  math  chip. 

Entry  Conditions: 

HL  contains  address  of  LSB  of  operand  A. 

DE  contains  address  of  LSB  of  operand  B. 

C  contains  command  to  execute. 

Exit  Conditions: 

HL  contains  MSB  address  of  operand  B. 

DE  contains  MSB  address  of  operand  A. 

A  &  C  contain  command. 

5.1.3  Routine  STH?:  STMP  will  read  a  result  from  the  math  pack  and 

store  it  at  the  location  specified  In  the  HL  registers: 

Entry  Condition: 

HL  contains  MSB  address  of  result. 

Exit  Conditions: 

HL  contains  LSB  address  of  result. 

A  register  destroyed. 

5.1.4  Routine  MPROY:  MPROY  checks  to  see  if  the  math  pack  is  ready 

(l.e.,  has  completed  the  last  operation)  with  no  errors.  When  the  math  pack 
is  ready  with  no  errors,  control  Is  returned  to  the  calling  routine.  If  the 

math  pack  Is  not  ready,  or  has  an  error,  control  Is  passed  to  EREX  (see 

Section  4.3.6)  which  halts  the  processor. 


Entry  Conditions:  None 

Exit  Conditions:  Mo  registers  destroyed. 

5.1.5  Math  Pack  Definitions  -  MPOEF: 

a.  MPOEF  is  a  data  module  which  defines  symbols  and  mnemonics 
associated  with  AMO  9511  arithmetic  processing  unit  (APU).  It  is  a  non-exe¬ 
cutable  module  containing  only  data  and  definitions.  The  PILOT  system  con¬ 
tains  two  APU's:  the  APU-85,  used  by  the  receiver  Interface  8085  processor, 
and  the  APU-80,  used  by  the  mainframe  8080  processor.  The  APU-80,  also 
mounted  on  the  receiver  interface  card.  Is  treated  as  memory-mapped  I/O  by  the 
3080  processor.  From  an  8080  standpoint,  the  APU-80  resides  at  four 
addresses:  3A00H  through  8A03H.  These  addresses  have  been  named  according  to 
their  functions: 

MPIN  EQU  8A00H  —  Data  Input  Port 
MPCMO  EQU  8A01H  —  Command  Input  Port 
MPOUT  EQU  8A02H  —  Oata  Output  Port 
MPSAT  EQU  8A03H  —  Status  Output  Port 

b.  The  receiver  Interface  hardware  decodes  these  addresses  and 
sets  up  and  executes  the  basic  software  math  handlers  (LDMP,  MPRDY,  and  STMP) 
used  to  communicate  between  the  8080  CPU  and  APU-80.  Communication  is  across 
the  "bottom-plane  bus."  Hardware  operation  and  details  can  be  found  in 
JHU/APL  S00  5699.1,  PILOT.  A  Precision  Intercoastal  Loran  Translocator. 
Volume  II  -  Hardware,  July  1980. 

5.1.6  Math  Pack  Routines  In  the  Receiver  Interface:  The  receiver 
interfaces  uses  the  same  math  pack  routines  (LDMP,  MPRDY,  and  STMP)  described 
in  Sections  5.1.1  through  5.1.4.  The  locations  of  the  math  pack  and  the  math 
pack  instructions  are  defined  In  MPDEF5  for  the  receiver  Interface.  No  calls 
are  made  to  MP0EF5  only  the  variables  defined  herein  are  used  by  other 
programs  in  the  receiver  interface. 

5.1.7  Zero  the  Math  Pack  -  ZRMP:  ZRMP  is  a  utility  module  that  will 
clear  the  math  pack  stack,  the  stack  for  the  AMO  9511  math  processing  chip 
consists  of  a  16-byte  linear  array.  The  array  operates  as  a  push-down  stack 
and  can  be  treated  as  four,  32 -bit  operands  for  double-precision  and  floating 
point  operations,  or  as  eight,  16-bit  operands  for  single-precision  oper¬ 
ations.  When  called,  ZRMP  will  set  to  zero  all  16  bytes  of  the  math  pack 
stack. 


Revised  Math  Routine  -  MAP: 


a.  To  reduce  the  coding  requirements  associated  with  the  math 
pack  handlers  described  In  Section  5.1,  the  routine  MAP  was  developed.  MAP  is 
used  primarily  In  the  transformation  software. 
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FIGURE  5-1  ROUTINE  MAP 


b.  The  flow  chart  used  for  MAP  Is  shown  in  Fig.  5-1.  To  use  MAP 
the  addresses  of  the  data  and  the  actual  operands  follow  the  call  to  the 
respective  program.  The  handler  software  decodes  the  data  and  operands  to 
take  the  appropriate  action. 

c.  All  operations  are  defined  in  MAPOEF.  These  operations  are 
the  standard  operations  defined  in  the  AMO  9511A  data  sheet  (Appendix  F)  with 
the  exception  of  operations  MPNOP,  RETD,  and  TERM.  MPNOP  is  the  math  pack 
NOP.  NOP  is  already  a  microprocessor  mnemonic  and,  therefore,  could  not  be 
used  with  respect  to  the  math  chip.  RETD  signals  MAP  to  retrieve  a  word  of 
data  from  the  math  chip  and  place  that  data  at  the  address  specified  following 
the  RETD  command.  TERM  informs  MAP  to  terminate  math  pack  commands  and  return 
to  the  calling  program. 

d.  The  address  of  any  operand  always  refers  to  the  Most  Signif¬ 
icant  Byte  (MSB)  of  the  operand.  MAP  adjusts  the  address  of  the  operand  as 
needed  to  point  to  the  ISB  or  MSB.  The  handler  software  requires  the  address 
of  the  operand  to  point  to  the  MSB  and  the  address  of  the  operand  plus  three 
to  point  to  the  ISB. 

5.3  Math  Pack  Routines  in  the  Receiver  Interface:  The  receiver 

interface  uses  the  same  math  pack  routines  (LDMP,  MPRDY,  and  STMP)  described 
in  Sections  5.1.1  through  5.1.4.  The  locations  of  the  math  pack  and  the  math 
pack  instructions  are  defined  in  MPDEF5  for  the  receiver  interface.  No  calls 
are  made  to  MP0EF5,  only  the  variables  defined  herein  are  used  by  other 
programs  in  the  receiver  interface.  The  APU-85,  mounted  on  the  receiver 
interface  card,  is  treated  as  memory-mapped  I/O  by  the  8085  processor.  From- 
an  3085  standpoint,  the  APU-85  resides  at  four  addresses:  1000  H  through 
1003  H.  These  addresses  have  been  named  according  to  their  functions: 

MPIN  EQU  1000  H  —  Oata  Input  Port 

MPCMO  EQU  1001  H  —  Command  Input  Port 
MPOUT  EQU  1002  H  —  Data  Output  Port 
MPSTAT  EQU  1003  H  —  Status  Output  Port 
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TAPE  CONVERT. 


6.1  Tape  Convert  Overview: 

a.  The  Tape  Convert  software  Is  a  stand-alone  module  used  to 
convert  navigation  source  tapes  to  object  tapes  which  are  used  by  the  PILOT 
terminal.  Tape  Convert  has  four  modes  of  operation  which  are  selected  by  the 
programmable  function  keys  fl,  f4,  f5,  and  f8.  The  four  keys  are  labeled: 

fl  -  START 
f4  -  DISPLAY  FILE 
fS  -  CONVERT  FILE 
f8  -  CONVERT  1  FILES 

b.  A  terminal  reset  (hard  or  soft)  will  load  the  four  function 
keys  (fl,  f4,  fS,  and  f8)  with  the  proper  escape  sequences  for  Tape  Conversion 
operation.  This  relieves  the  operator  from  having  to  define  the  function  keys 
each  time  the  Tape  Convert  program  Is  to  be  used. 

c.  A  description  of  each  of  the  four  Tape  Convert  function  keys 

f o 1 1 ows : 


1.  fl  -  START.  The  START  mode  rewinds  both  tapes  and 

copies  files  1  and  2  from  the  source  tape  (left  tape 

unit)  to  the  object  tape  (right  tape  unit).  It  Is  used 

to  copy  the  Index  file  (file  1)  and  the  reserved  file 
(file  2)  directly  from  the  source  tape  to  the  object 
tape.  The  START  key  functions  as  follows: 

(a)  Find  file  1  on  left  tape. 

(b)  Find  file  1  on  right  tape. 

(c)  Copy  2  files  from  left  to  right  tape. 

(d)  Home  the  cursor  and  clear  the  screen. 

(e)  Display  the  following  message  on  the  screen  to 

Indicate  the  completion  of  the  START  mode. 

'FILES  1  and  2  COPIED’ 

2.  f4  -  DISPLAY  FILE.  The  OISPLAY  file  mode  reads  one  file 
from  the  source  tape  (left  tape  unit)  to  the  screen  in 
the  display  functions  mode.  It  Is  used  to  display  a 
source  file  to  which  changes  need  to  be  made.  The 
DISPLAY  FILE  key  functions  as  follows: 

(a)  Home  the  cursor  and  clear  the  screen. 

(b)  Turn  display  functions  mode  on. 

(c)  Read  a  file  from  the  left  tape  to  the  screen. 

(d)  Turn  display  functions  mode  off. 

(e)  Home  the  cursor. 


f5  -  CONVERT  FILE. 


(a)  The  CONVERT  FILE  mode  converts  the  source  file  that 
is  displayed  on  the  screen.  It  is  used  to  convert 
a  source  file  to  which  changes  have  been  made  by 
the  operator.  The  CONVERT  FILE  key  functions  as 
f o 1 1 ows : 

(1)  Home  the  cursor. 

(2)  Read  a  file  from  the  screen  to  memory. 

(3)  Perform  the  tape  conversion. 

(4)  Write  the  object  file  to  the  right  tape. 

(5)  Display  the  following  message  on  the  screen  to 
Indicate  the  completion  of  the  CONVERT  FILE 
mode: 

1 ***TAPE  CONVERT  COMPLETED***' 

(b)  The  Tape  Convert  software  looks  at  row  1,  column  16 

of  the  source  file  to  decide  whether  a  master  file 
or  a  detail  file  is  being  converted.  An  "M"  in 
this  location  indicates  a  master  file,  and  a  "D" 
indicates  a  detail  file.  If  any  other  character 
appears  in  this  location,  then  an  error  message  is 
displayed  on  the  screen  and  no  file  conversion 
occurs.  The  error  message  displayed  to  the 

operator  Is: 

****ERR0R  *  FILE  NOT  MASTER  OR  DETAIL***' 
f8  -  CONVERT  71  FILES. 

(a)  The  CONVERT  11  FILES  mode  converts  files  directly 
from  the  source  tape  (left  tape  unit)  to  the  object 
tape  (right  tape  unit).  The  operator  selects  the 
number  of  files  to  be  converted.  It  is  used  to 
convert  source  files  to  which  no  corrections  need 
to  be  made.  The  CONVERT  FILES  key  functions  as 
follows: 

(1)  Home  the  cursor  and  clear  the  screen. 

(2)  Oisplay  the  following  message  on  the  screen: 

'CONVERT  :]  FILES’ 

The  character  Is  displayed  inside  a  two* 
column  wide  Inverse  video  field.) 

(3)  The  operator  must  then  enter  a  one-  or  two- 
digit  number  (range  1-99),  followed  by  a 
carriage  return,  to  select  the  number  of  files 
to  convert.  (The  entered  characters  are 
echoed  back  on  the  screen  Inside  the  Inverse 
video  field.) 

(4)  Read  a  file  from  the  left  tape  Into  memory. 

(5)  Perform  the  taoe  conversion. 

(6)  Write  the  object  file  to  the  right  tape. 


(7)  Repeat  steps  4-6  above  until  the  correct 
number  of  files  have  been  converted,  or  until 
the  end  of  data  mark  is  detected  after  reading 
to  the  left  tape. 

(3)  Display  the  following  message  on  the  screen  to 
indicate  the  completion  of  the  CONVERT T|  FILES 
mode: 

•***TAPE  CONVERT  COMPLETED***' 

(b)  The  operator  must  enter  a  one-  or  two-digit  number 
from  the  keyboard  in  step  3  above.  Only  numerical 
characters  (0-9)  can  be  entered.  If  any  other  key 
is  hit,  it  is  Ignored,  and  the  bell  will  sound.  If 
a  third  numerical  character  is  entered,  an  error 
message  is  immediately  displayed,  and  the 
CONVERT?]  FILES  mode  is  aborted.  The  error  message 
reads : 

'*** ILLEGAL  KEYBOARD  INPUT  -  TAPE  CONVERT  ABORTED***' 

(c)  The  number  entered  cannot  be  zero.  If  a  zero 
character  followed  by  a  carriage  return  (or  only  a 
carriage  return)  Is  entered,  then  the  message  above 
Is  displayed,  and  this  mode  is  aborted. 

(d)  Because  only  the  numerical  keys  are  active,  the 
operator  cannot  change  an  entered  number  by  back¬ 
spacing  the  cursor.  The  only  option  to  the  oper¬ 
ator  would  be  to  enter  a  three-digit  number,  which 
aborts  this  mode.  The  operator  can  then  select  the 
CONVERT  ?!  FILES  mode  again  to  enter  the  correct 
number'. 

(e)  The  operator  can  enter  a  number  greater  than  the 
number  of  files  on  the  source  tape.  If  an  end  of 
data  mark  Is  detected  after  reading  the  source 
tape,  then  the  tape  conversion  Is  ended. 

(f)  After  the  one-  or  two-digit  number  is  entered,  the 
operator  must  hit  the  carriage  return  key  to  start 
the  Tape  Convert  process.  The  Inverse  video  field 
around  the  entered  number  is  removed,  and  the  tape 
conversion  begins.  A  message  Is  displayed  to  the 
operator  after  all  files  have  been  converted. 

(g)  The  Tape  Convert  software  looks  at  row  I,  column  16 
of  the  source  file  to  decide  whether  a  master  file 
or  a  detail  file  Is  being  converted,  as  described 
in  the  CONVERT  FILE  mode.  If  any  source  file 
contains  an  Illegal  character  at  this  location, 
then  an  error  message  Is  displayed,  and  the  tape 
conversion  stops  at  this  point. 


(h)  If  an  error  Is  detected  during  a  tape  read  oper¬ 
ation,  or  if  an  error  condition  occurs  during  a 
math  pack  operation,  then  an  error  message  is 
displayed,  and  the  terminal  halts.  The  error 
message  reads: 

•FATAL  ERROR  -  RESTART  REQUIRED' 

The  most  likely  cause  of  a  math  pack  error  is  a 
wrong  format  number  or  a  number  out  of  bound  on  the 
source  file.  A  terminal  resest  is  required  if  this 
error  occurs. 

6.2  Tape  Convert  Software  -  TC: 

a.  The  Tape  Convert  (TC)  software  resides  in  the  HP  terminal 
along  with  the  HP  operational  software.  Normal  terminal  operation  is  not 
affected  by  the  addition  of  the  Tape  Convert  software.  Tape  Convert  resides 
in  4K  bytes  of  memory,  beginning  at  location  COOO  H.  The  TC  software  is 
contained  in  two  EPROM's,  at  location  COOO  H  and  C800  H,  and  extends  to  loca¬ 
tion  C953  H,  leaving  adequate  space  for  expansion  in  the  second  EPROM.  The  TC 
software  uses  RAM  from  location  D600  H  to  DFFF  H.  A  memory  map  for  the  TC 
software  is  shown  in  Fig.  6-1. 

b.  The  link  procedure  requires  both  the  TC  disk  and  the  UTIL 

disk. 

c.  To  incorporate  the  TC  software  Into  the  terminal,  some 
patches  were  made  to  the  HP  software  module  HPOO.  These  changes  are  shown  in 
Fig.  6-2.  The  patches  were  made  to  change  some  memory  bounds  and  to  program 
the  function  keys  for  TC  operation.  In  addition  to  the  two  TC  EPROM's  at 
locations  COOO  H  and  C800  H,  an  EPROM  for  module  HPOO  (located  at  0000  H), 
which  includes  the  above  patches,  must  also  be  Installed  in  the  terminal. 

d.  Entry  Is  made  Into  the  TC  software  via  four  programmable 
function  keys  (fl,  f4,  f5,  and  f 8) •  The  function  keys  are  loaded  with  the 
proper  escape  sequence  when  the  RESET  TERMINAL  key  Is  hit. 

e.  The  first  four  Instructions  In  executive  program  TCONV  are 
the  entry  vectors  Into  the  TC  software.  These  locations  are  used  in  the 
escape  sequences  that  program  the  function  keys.  The  first  three  entry  vec¬ 
tors  are  used  for  three  of  the  function  keys,  the  fourth  entry  vector  is  used 
for  the  RESET  key.  One  function  key  executes  entirely  by  escape  sequence. 

f.  Figure  6-3  shows  a  flow  diagram  for  the  TC  executive  pro¬ 
gram.  Entry  Into  the  executive  Is  via  the  four  progranmable  function  keys 
(fl,  f4,  f5,  and  f3)  or  the  RESET  key.  Exit  from  the  executive  is  always  made 
Into  the  HP  wait-loop  (location  294  H). 

g.  Function  key  fl  (START  mode)  executes  entirely  from  escape 
sequence.  It  copies  files  1  and  2  from  the  left  tape  (source)  to  the  right 
tape  (object). 
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FIGURE  6-1  TAPE  CONVERT  MEMORY  MAP 


h.  Function  key  f4  (OISPLAY  FILE  mode)  is  programmed  to  jump  to 
subroutine  SREAO,  which  reads  a  source  file  from  the  left  tape  to  the  screen 
in  the  display  functions  mode. 

i.  Function  key  f5  (CONVERT  FILE  mode)  is  programmed  to  jump 
into  TCONV  at  entry  point  SNGL.  This  mode  converts  the  source  file  that  is 
displayed  on  the  screen.  8efore  entering  the  main  executive  loop,  the  screen 
is  selected  as  the  source  file  input  device,  and  the  number  of  files  to 
convert  is  set  to  one. 

j.  Function  key  f8  (CONVERT  7j  FILES  mode)  will  convert  an 
operator-selected  number  of  files  directly  from  the  source  tape.  This  key  is 
programmed  to  jump  into  TCONV  at  entry  point  MULT.  Before  entering  the  main 
executive  loop,  the  number  of  files  to  convert  is  entered  by  the  operator. 
Subroutine  INPUT  controls  and  processes  the  keyboard  entries.  The  left  tape 
is  selected  as  the  source  file  input  device. 

k.  Once  in  the  main  executive  loop,  a  source  file  is  read  into 
memory  (at  location  Ml)  from  the  selected  input  device.  To  determine  whether 
master  or  detail  processing  should  follow,  a  check  is  made  on  the  character  at 
location  Ml-15  bytes.  If  it  is  an  ASCII  "M,“  master  file  conversion  is  selec¬ 
ted;  if  it  is  an  ASCII  "0,"  detail  file  conversion  follows.  Any  other  charac¬ 
ter  at  this  location  will  terminate  the  Tape  Convert  mode.  This  executive 
loop  will  continue  until  the  selected  number  of  files  has  been  converted. 
Messages  are  displayed  to  indicate  when  an  error  condition  occurs,  or  when 
processing  is  completed. 

6.2.1  Tape  Convert  Routines; 

a.  Routine  TCONV  is  the  Tape  Convert  executive  program.  It 
contains  the  entry  vectors  for  the  function  keys  and  the  terminal  reset  key. 
TCONV  includes  the  entry  points  to  convert  one  file  from  the  screen  (SNGL), 
and  to  convert  multiple  flies  from  the  source  tape  (MULT).  The  source  file  is 
read  into  memory  from  the  selected  device.  The  executive  selects  master  or 
detail  processing  on  the  input  file.  The  loop  continues  until  all  files  are 
converted.  Upon  completion,  a  message  is  output  to  the  display,  and  TCONV 
returns  to  the  HP  wait-loop. 

b.  Routine  SREAO  reads  a  source  file  from  the  left  tape  unit  and 
displays  it  on  a  screen  in  OISPLAY  FUNCTIONS  mode.  The  OISPLAY  FUNCTIONS  mode 
is  turned  off  upon  exit.  SREAO  Is  entered  by  the  operator  selection  of  the 
appropriate  function  key.  The  entry  vector  to  SREAO  is  contained  in  TCONV. 
SREAO  returns  to  the  HP  wait-loop. 

c.  Routine  RESET  programs  the  soft  function  keys  for  the  Tape 
Convert  entry  points.  RESET  is  called  by  HP  software  module  HPOO  at  location 
291  H.  It  will  be  called  when  the  terminal  reset  key  is  hit.  The  escape 
sequence  that  loads  the  function  key  definitions  is  located  at  PFK  in  module 
TCMSG.  RESET  returns  to  the  HP  wait-loop. 

d.  Routine  TCMSG  contains  the  operator  messages  and  the  escape 
sequences  that  are  used  in  the  Tape  Convert  software.  TCMSG  is  a 
non-executable  module. 


r 


rl 
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e.  Routine  INPUT  processes  a  two-digit  number  entered  via  the 
keyboard  by  the  operator.  INPUT  waits  for  characters  to  be  entered.  Non- 
numerical  keys  are  not  accepted,  and  the  bell  will  sound  If  they  are  hit.  The 
carriage  return  key  indicates  the  end  of  operator  input.  An  illegal  input  is 
no  characters,  a  zero,  or  more  than  two  digits.  INPUT  is  called  by  TCONV. 

f.  Routine  RAF  reads  a  file  from  the  selected  input  device  and 
stores  the  data  in  memory.  RAF  stores  a  00  H  byte  in  memory  following  the  end 
of  data.  RAF  will  exit  on  a  tape  end  of  file,  tape  end  of  data,  or  a  display 
end  of  memory.  On  a  tape  end  of  data,  RAF  sets  variable  NFILE  »  -1.  RAF  is 
called  by  TCONV. 


g.  Routines  OMSG/DCHAR  add  messages  onto  the  screen.  DMSG  will 
display  the  message  at  the  line  under  the  present  cursor  position  starting  at 
column  4.  OCHAR  will  display  the  message  starting  at  the  present  cursor 
position.  The  ASCII  message  must  be  terminated  with  a  00  H  byte. 

h.  Routines  ESCI/ESCS  execute  an  escape  sequence.  The  escape 
sequence  Issues  a  command  to  the  HP  terminal.  The  escape  sequence  begins  with 
an  escape  character  (18  H)  and  terminates  with  a  null  character  (00  H).  Entry 
point  ESCS  allows  an  ASCII  string  to  be  output  to  the  terminal  display. 

6.2.2  Mas ter /Pet a 11  File  Conversion: 

a.  The  Tape  Convert  software  contains  two  subroutines,  MCON  and 
OCON,  which  convert  a  source  file  to  an  object  tape  file.  Subroutine  MCON 
converts  a  master  file,  and  subroutine  OCON  converts  a  detail  file.  The  Tape 
Convert  executive,  TCONV,  calls  the  appropriate  subroutine  after  a  source  file 
has  been  read  into  memory. 

b.  Subroutine  MCON  converts  a  master  source  file  to  object  tape 
format.  The  ASCII  data  from  the  source  file  must  appear  in  memory  beginning 
at  location  Ml  (0797  H).  The  master  source  file  consists  of  12  lines  of 
alphanumeric  data,  followed  by  up  to  IS  lines  of  graphics  data.  There  Is 
space  in  memory  for  1232  bytes  of  master  graphics  data.  The  alphanumeric  data 
appear  in  specifically  defined  fields.  The  beginning  of  each  field  is  defined 
in  the  TCOM  module  under  the  Master  File  -  Screen  Format  section.  The  source 
data  in  memory  Includes  some  ASCII  control  characters  In  addition  to  the 
numerical  characters.  Each  line  in  the  source  file  begins  with  a  03  control 
character,  and  each,  line  ends  with  a  carriage  return  and  a  line  feed 
character. 


c.  ASCII  conversion  subroutines  ASCFP  and  ASCSF  require  that  the 
ASCII  string  not  cross  a  256-byte  boundary  in  memory.  This  occurs  three  times 
in  the  master  file:  at  location  M248+1  (0800  H),  M63+5  (0900  H),  and  M948 
(OAQO  H).  Therefore,  the  data  field  beginning  at  location  M248  is  restricted 
to  the  last  14  characters,  and  the  field  beginning  at  location  M63  is 
restricted  to  the  last  10  characters. 

d.  Double  fixed-point  data  (located  In  fields  M53  and  M73)  must 
appear  right-justified  In  the  15-character  field.  Subroutine  ASCOF  is  called 
to  convert  an  eight-character  string  which  begins  at  locations  M53+7  or  M73+7. 


e.  After  converting  the  ASCII  data  from  the  source  file  into  the 
appropriate  floating  or  fixed-point  format,  MCON  will  write  the  object  file  to 
the  right  tape  unit.  The  first  record  in  the  master  object  file  contains  the 
converted  alphanumeric  data.  The  record  size  Is  253  bytes.  The  alphanumeric 
record  is  followed  by  up  to  five  graphics  records.  Each  graphic  record 
contains  three  lines  of  graphics  data.  The  graphics  data  are  transferred  from 
the  source  data  that  appear  in  memory  to  the  object  tape.  An  end-of-file  mark 
is  written  to  the  object  tape  following  the  last  graphics  record. 

f.  Subroutine  DCON  converts  a  detail  source  file  to  object  file 
format.  The  source  data  must  appear  in  memory  beginning  at  location  01  (0797 
H).  The  detail  source  file  consists  of  five  lines  of  alphanumeric  data 
followed  by  up  to  10  lines  of  graphics  data.  There  is  space  in  memory  for  813 
bytes  of  graphics  data. 

g.  The  TCOM  module  defines  the  start  address  for  each  field  in 
the  alphanumeric  section  of  the  detail  file.  The  detail  file  includes  one 
256-byte  boundary,  at  location  0248+1  (0800  H).  The  data  in  this  field  are 
restricted  to  the  last  14  characters.  There  are  three  double  fixed-point 
parameters  in  the  detail  file,  located  at  053,  0518,  and  0533.  The  data  in 
these  fields  must  be  right  justified. 

h.  After  converting  the  ASCII  source  data  into  floating-  or 
fixed-point  format,  DCON  will  write  the  object  file  to  the  right  tape  unit. 
The  first  record  in  the  detail  object  file  consists  of  the  converted  alphanu¬ 
meric  data  (123  bytes),  followed  by  up  to  three  graphics  records,  with  each 
record  consisting  of  three  lines  of  graphics  data.  An  end-of-file  mark  is 
written  to  the  object  tape  following  the  last  detail  graphics  record. 

i.  Oetailed  descriptions  of  the  various  subroutines  associated 
with  file  conversion  are  In  the  following  sections. 

6.2.3  Master  File  Conversion  -  MCON:  Subroutine  MCON  converts  a  master 
source  file  to  object  tape  format.  The  master  file  must  appear  in  memory  at 
location  Ml.  The  object  tape  records  are  written  to  the  right  tape  unit,  and 
an  end-of-file  mark  is  written  following  the  object  file.  MCON  is  called  by 
the  Tape  Convert  executive,  TCONV.  TCONV  is  discussed  in  Section  6.2.1. 

6.2.4  Petal!  File  Conversion  -  DCOM:  Subroutine  OCON  converts  a  detail 
source  file  to  object  tape  format.  Thi  detail  source  file  must  appear  In 
memory  at  location  01.  The  object  tape  records  are  written  to  the  right  tape 
unit,  and  an  end-of-file  mark  Is  written  following  the  object  file.  DCON  is 
called  by  the  Tape  Convert  executive,  TCONV. 

6.2.5  Tape  Convert  Common  Variables  -  TCOM;  Subroutine  TCOM  contains 
all  common  variables  used  in  the  Tape  Convert  software.  TCOM  variables  are 
contained  in  the  memory  space  from  0600  H  to  OFFF  H.  TCOM  is  a  non-executable 
module. 

6.2.6  Write  a  Record  -  WAR:  Subroutine  WAR  writes  a  data  record  to  the 
right  tape  unit  ^rom  memory.  After  issuing  the  write  record  command,  WAR 
monitors  tape  motion  status  and  exits  when  tape  motion  stops.  The  maximum 
record  length  is  256  bytes. 
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6.2.7  Write  End  of  File  -WAEOF:  Subroutine  WAEOF  writes  an  end-of-file 
(EOF)  mark  to  the  right  tape  unit.  Jfrter  Issuing  the  write  EOF  command,  WAEOF 
monitors  tape  motion  status  and  exits  when  tape  motion  stops. 

6.2.8  Graphics  End  of  Data  -  GRAX:  Subroutine  GRAX  is  called  before 
writing  a  graphics  data  record  to  t.,2  object  tape.  GRAX  has  three  func¬ 
tions:  (1)  to  look  ahead  through  three  lines  of  graphics  data  for  the  end  of 
data  (E00)  mark  (a  00  H  byte),  (2)  to  determine  the  number  of  bytes  contained 
in  the  three  lines,  and  (3)  to  save  the  start  address  of  the  next  three  lines 
of  graphics  data.  Subroutine  GRAX1  performs  the  same  functions,  except  that 
it  looks  through  only  one  line  of  graphics  data. 

6.2.9  Space  Check  -  SPC:  Subroutine  SPC  searches  an  ASCII  string  for 
the  first  non -space  ASCII  character.  The  address  of  the  first  non-space  ASCII 
character  is  returned  to  the  calling  program. 

6.2.10  ASCII  to  Single  Fixed  Point  -  ASCSF:  Subroutine  ASCSF  converts  an 
ASCII  string  to  a  single  precision,  fixed-point  number  (2  bytes).  The  ASCII 
string  must  be  left  justified  (no  leading  space  characters).  This  can  be 
performed  by  calling  subroutine  SPC.  which  skips  over  leading  spaces  in  the 
ASCII  string.  The  ASCII  string  must  not  cross  over  a  256-byte  boundary  In 
memory. 


6.2.11  ASCII  to  Double  Precision  Fixed  Point  -  ASCDF:  Subroutine  ASCOF 
converts  an  ASCII  string  to  a  double  precision  fixed-point  number  (4  bytes). 
ASCOF  will  only  convert  positive  Integer  numbers.  The  ASCII  string  must 
contain  eight  characters  and  be  right  justified.  Leading  spaces  are  permitted 
and  will  be  Interpreted  as  zeros.  The  characters  in  the  ASCII  string  are 
converted  to  BCD  digits  and  restored  In  memory  before  the  double  fixed-point 
conversion  occurs. 

6.2.12  BCD  to  Binary  Conversion  -  BCOBIN:  Subroutine  3CD3IN  converts  an 
eight-digit  BCO  number  to  a  double  precision  fixed-point  number.  3CD8IN  will 
only  convert  positive  integer  numbers.  Each  BCO  digit  occupies  one  byte.  The 
eight-byte  BCO  number  must  be  right  justified.  SC0B1N  is  called  by  subroutine 
ASCOF  to  complete  the  ASCII  to  a  double  precision  fixed-point  conversion. 
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